How-to
Start Starboard on Debian
Debian with no desktop is the lightest system for Starboard, so it suits an older or smaller computer. This page takes you from Debian 13 on a computer to Starboard's set-up. You finish the set-up in the terminal, or in a browser on a phone or another computer. It takes about 20 minutes.
Before you begin
- Debian 13 or later on the computer that will be your server, installed with no desktop and an empty root password. To install it, follow Install Linux on a computer.
- A computer with at least 2 cores, 2 GB of memory and 20 GB for the system. Read The four systems for the recommended computer.
- The user name and password you made while installing Debian.
Steps
- Sign in to Debian with a monitor and keyboard, or from your own computer with Connect to your server from another computer.
- Check that Debian is online. A network cable is the most reliable. Read Check whether the server is online.
- Enter this command and press Enter. A new Debian has
wgetbut notcurl, so this command useswget:
wget -qO- https://raw.githubusercontent.com/TheMightyTRex/starboard/main/run-first.sh | bash
- Press Enter at each question to take the recommended answer. When it asks for your password, enter it and press Enter. Nothing appears as you enter it.
- At How do you want to finish setting up?, press Enter for Here in the terminal (recommended). Read Set up Starboard in the terminal, with no browser. To use a browser instead, choose In a browser, then open the address it shows on a phone or another computer and enter the setup code.
The Run first script installs git and Docker, which a new Debian does not have. Read Set up everything with the Run first script for what each step does.
If it does not work
- An error number, or "error: 404": read If it does not work in the Run first article.
- "sudo: command not found", "is not in the sudoers file" or error RF-16: a root password was set while
installing, so your user cannot install software yet. Give it that right, with your user name in place of
sam:
su -
Enter the root password, then:
apt install sudo && usermod -aG sudo sam
Enter exit, sign out and back in, and run the command in step 3 again.
- "Media change: please insert the disc labeled": Debian still lists the installer's USB stick as a place to
get software. Remove it from the list, then run the command in step 3 again:
sudo sed -i '/cdrom/s/^deb/# deb/' /etc/apt/sources.list
- "wget: command not found": install it, then run the command in step 3 again:
sudo apt update && sudo apt install wget
- "Temporary failure in name resolution", "Network is unreachable" or error RF-11: Debian is not online. Read Connect to the internet, by cable or Wi-Fi.
Find out more
This page on GitHub, where the help is written.