Skip to content

Revise Debian installation guide for Trixie #21492

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Automation-Dude wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Revise Debian installation guide for Trixie #21492

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions docs/docs/guides/getting_started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,12 @@ This section guides you through setting up a server with Debian Bookworm and Doc

There are many guides on how to install Debian Server, so this will be an abbreviated guide. Connect a temporary monitor and keyboard to your device so you can install a minimal server without a desktop environment.

:::tip

The latest version of Debian is no longer Debian 12 (Bookworm) but instead is now Trixie. In some instances, by following these instructions you may have to update the source lists manually. As (Trixie) handles formatting the list files differently it can be confusing when trying to follow this guide step by step. See below for simple instructions to get you started should you be starting with Trixie for a new install.

:::

#### Prepare installation media

1. Download the small installation image from the [Debian website](https://www.debian.org/distrib/netinst)
Expand All @@ -47,6 +53,39 @@ There are many guides on how to install Debian Server, so this will be an abbrev
```
1. Shutdown by running `poweroff`

#### Install and setup Debian (Trixie) for remote access

1. Ensure your device is connected to the network so updates and software options can be installed
1. Choose the non-graphical install option if you don't have a mouse connected, but either install method works fine
1. You will be prompted to set the root user password and create a user with a password
1. Install the minimum software. Fewer dependencies result in less maintenance.
1. Uncheck "Debian desktop environment" and "GNOME"
1. Check "SSH server"
1. Keep "standard system utilities" checked
2. After reboot, login as root at the command prompt
1. Navigate to the sources.list directory
```bash
cd /etc/apt
nano sources.list
```
1. Update the blank contents to the bare minimum for Trixe
```bash
deb http://deb.debian.org/debian trixie main non-free-firmware
deb http://deb.debian.org/debian trixie-updates main non-free-firmware
deb-src http://deb.debian.org/debian trixie main non-free-firmware
deb-src http://deb.debian.org/debian trixie-updates main non-free-firmware
```
1. Press CTRL+X and save to the same file name buffer
1. Install sudo
```bash
apt update && apt install -y sudo
```
1. Add the user you created to the sudo group (change `blake` to your own user)
```bash
usermod -aG sudo blake
```
1. Shutdown by running `poweroff`

At this point, you can install the device in a permanent location. The remaining steps can be performed via SSH from another device. If you don't have an SSH client, you can install one of the options listed in the [Visual Studio Code documentation](https://code.visualstudio.com/docs/remote/troubleshooting#_installing-a-supported-ssh-client).

#### Finish setup via SSH
Expand Down