On this page

How-to

Install Linux on a computer

Put Linux on the computer that will be your server, from a USB stick. At the end the computer starts Linux by itself and you can sign in with your own user name and password. It takes about 45 minutes, most of it waiting.

Before you begin

  • The computer you will use as the server, big enough for what you want. Read What you need to run Starboard.
  • A USB stick of 8 GB or more. Everything on it is erased.
  • Another computer to download Linux and write the USB stick.
  • A monitor, keyboard and network cable for the server, for this hour only.
  • Anything you want to keep from the server computer, copied somewhere else. Installing Linux erases its disk.

Choose which Linux

Starboard supports four systems, in the version named here or any later one. Choose by how you will use the server:

You want Install Why
A screen on the server, and the set-up in its browser Linux Mint 22.3 (recommended) A desktop that is familiar; the set-up opens in its browser by itself
No screen: the set-up in the terminal, or from a phone or laptop Debian 13 The lightest: it leaves the most memory for your apps
No screen, with 5 years of updates Ubuntu Server 26.04 LTS Long support, and many guides online
A Raspberry Pi Raspberry Pi OS (64-bit) Follow Prepare a Raspberry Pi instead of this page

A desktop uses 500 MB to 1.5 GB of memory even when nobody uses it. On a computer with 4 GB of memory or less, choose Debian and finish set-up from a phone or laptop. Read The four systems for the minimum and recommended computer for each.

Steps

  1. On your other computer, download the installer file (it ends in .iso): - Linux Mint 22.3: the Cinnamon Edition from linuxmint.com. Linux Mint's installation guide shows every step with pictures. - Debian 13: the netinst file for 64-bit PC (amd64) from debian.org. Debian's installation guide explains every question. - Ubuntu Server 26.04 LTS from ubuntu.com. Ubuntu's guide to installing Ubuntu Server shows every step.
  2. Write the file to the USB stick with balenaEtcher: select Flash from file, choose the .iso file, choose the USB stick, then select Flash. On Windows, Rufus also works.
  3. Put the USB stick and the network cable in the server computer and power it on. Straight away, press the key that opens the start-up menu, often F12, F11, F10 or Esc, and choose the USB stick. If the computer starts its old system instead, power it off and try another key.
  4. Follow the installer. For Debian: - Choose Install, not Graphical install, if the mouse does not work. - When it asks for a root password, leave it empty and select Continue. Your own user then gets administrator rights through sudo. - Choose your user name and a password you will remember. The terminal asks for it later. - At Software selection, deselect Debian desktop environment and GNOME, and select only SSH server and standard system utilities. Press the space bar to select or deselect, and Enter to go on.
  5. For Linux Mint, choose Install Linux Mint, then Erase disk and install Linux Mint, and choose your user name and password. Accept the other suggested answers. For Ubuntu Server, select Install OpenSSH server, select nothing under Featured server snaps, and choose your user name and password. Accept the other suggested answers.
  6. When the installer says it has finished, remove the USB stick and let the computer restart.
  7. Sign in with your user name and password. On Debian and Ubuntu Server, a line ending in $ appears: that is the terminal, ready for commands. On Linux Mint, open a terminal from Menu, Terminal.
  8. Install the updates that came out after your installer file. It asks for your password:
sudo apt update && sudo apt upgrade

When it asks "Do you want to continue?", enter y and press Enter.

  1. Write down the computer's address on your network, to connect from another computer later:
hostname -I

The first group of four numbers, such as 192.168.1.20, is its address.

Things to note

If it does not work

  • The computer never shows the USB stick: write the stick again, or try another USB port. On some computers, the start-up menu only lists the stick after you activate USB boot in the computer's own settings, opened with F2 or Delete at start-up.
  • "Secure Boot violation" or a similar message: Linux Mint, Debian and Ubuntu all work with Secure Boot. Write the stick again from a freshly downloaded file. If it still happens, deactivate Secure Boot in the computer's own settings.
  • The server is not online after installing: follow Connect to the internet, by cable or Wi-Fi.
  • Debian finds no network: check the cable. Debian does not set up Wi-Fi without extra files, and a cable is more reliable for a server anyway.
  • "sudo: command not found" or "is not in the sudoers file" on Debian: you set a root password in step 4. Give your user the right to use sudo with If it does not work in Start Starboard on Debian, or install Linux again and leave the root password empty.

Find out more

This page on GitHub, where the help is written.