On this page

Install Starboard on a Linux computer

This guide takes you from a Linux computer to Starboard open in your browser, with your own password. It is for anyone, including people who have never used a terminal. It takes about 30 minutes, most of it waiting for downloads.

It works on Linux Mint 22.3 (recommended), Debian 13 and Ubuntu Server 26.04, or a later version of each. No Linux yet? Follow Get Starboard up and running, from a bare computer. For a Raspberry Pi, follow Install Starboard on a Raspberry Pi.

Before you begin

  • A computer running Linux that can stay powered on. Check it is big enough in The four systems.
  • The computer is connected to your home network, by cable or Wi-Fi.
  • You know the password you use to sign in to that computer. The terminal asks for it.
  • If the terminal is new to you, read The terminal: entering commands first.

The steps at a glance

  1. Open a terminal on the computer, or connect to it.
  2. Run the Run first script, which installs Docker and Starboard.
  3. Create your password and finish setting up.
  4. Open Starboard from your phone or another computer.
Flow chart: 1. Open a terminal. The same chart is written out in words after it.1. Open a terminal2. Run the Run firstscript3. Create your password4. Open it from yourphone
The chart in words

Start: 1. Open a terminal

  • Then: 2. Run the Run first script
    • Then: 3. Create your password
      • Then: 4. Open it from your phone

Step 1: Open a terminal

On Linux Mint, open Terminal from Menu. On a server with no desktop, sign in to it, or connect from your own computer with Connect to your server from another computer.

It worked when the terminal shows a line ending in $, ready for a command.

Step 2: Run the Run first script

One command checks the computer, installs Docker and anything else missing, downloads Starboard and starts its installer. Follow the page for your system: Start Starboard on Linux Mint, on Debian or on Ubuntu Server. Each step is explained in Set up everything with the Run first script.

It worked when the installer says "Starboard is running".

Step 3: Create your password and finish setting up

With a desktop, the set-up page opens by itself with the setup code filled in. With no desktop, open the address it shows on a phone or another computer and enter the setup code. Follow Create your password and sign in. In the terminal instead, follow Set up Starboard in the terminal, with no browser.

It worked when Starboard opens its dashboard.

Step 4: Open Starboard from your phone or another computer

To use Starboard from your phone or laptop, open the server's address with :8095, while the phone is on the same Wi-Fi. Follow Open Starboard from a phone or another computer.

What next

This page on GitHub, where the help is written.