On this page

Get Starboard up and running, from a bare computer

This guide takes you from a computer with nothing on it to a working media server. You install Linux, then run one script, the Run first script, which sets up everything else. It is for anyone, including people who have never used a terminal. It takes an afternoon, most of it waiting for downloads.

After the Run first script the guide splits into two paths. Both end in the same place:

  • With a browser: you finish set-up in Starboard's set-up guide, on the server or on a phone or laptop.
  • Terminal only: you answer the same questions in the terminal. For a server with no desktop and nothing else to finish on.

Before you begin

  • A computer to use as the server, big enough for what you want. Check The four systems.
  • A USB stick of 8 GB or more, and another computer to prepare it. For a Raspberry Pi, a microSD card instead.
  • A disk for your media: plan for 1 TB or more for films and series.
  • If the terminal is new to you, read The terminal: entering commands first.
  • Want a helper beside you? Ask an AI assistant to help you set up has a prompt to copy into one.

The steps at a glance

  1. Choose your path.
  2. Install Linux.
  3. Connect from your own computer (only for a server with no desktop).
  4. Run the Run first script. It installs Docker and starts Starboard's installer.
  5. With a browser: create your password and set up in the browser. Terminal only: answer the set-up questions in the terminal.
  6. Add your media apps.
Flow chart: 1. Choose your path. The same chart is written out in words after it.With a browserTerminal only1. Choose your path2. Install Linux3. Connect from your owncomputer4. Run the Run firstscript5. Create your passwordand set up in the browser5. Answer the set-upquestions in the terminal6. Add your media apps
The chart in words

Start: 1. Choose your path

  • Then: 2. Install Linux
    • Then: 3. Connect from your own computer
      • Then: 4. Run the Run first script
        • With a browser: 5. Create your password and set up in the browser
          • Then: 6. Add your media apps
        • Terminal only: 5. Answer the set-up questions in the terminal
          • Then: go to 6. Add your media apps

Steps 1 to 4 are the same for everyone. Step 5 is either the browser or the terminal, and both lead to step 6.

Step 1: Choose your path

Choose with a browser if the server has a desktop, or if you have a phone or laptop on the same network. Choose terminal only if the server has no desktop and you have nothing else to finish on. Your choice decides which Linux to install in step 2: read Choose which Linux. The Run first script suggests the right path for the computer, and you can still open Starboard in a browser later.

Step 2: Install Linux

Follow Install Linux on a computer. For a Raspberry Pi, follow Prepare a Raspberry Pi instead. Then check the server is online, and connect it if it is not: follow Connect to the internet, by cable or Wi-Fi.

It worked when the computer starts Linux by itself, you can sign in, and ping -c 3 debian.org shows replies.

Step 3: Connect from your own computer

On a server with no desktop, work from your own computer, where you can copy and paste commands. Follow Connect to your server from another computer. If the server has a desktop, skip this step and open its terminal.

It worked when your terminal shows the server's name at the start of the line.

Step 4: Run the Run first script

One command checks the computer, installs Docker and anything else that is missing, downloads Starboard and starts its installer. It asks before it changes anything, and offers an accessible mode for software that reads text aloud. If Linux is still installing its own updates, it waits for them with a progress bar. Follow the page for your system: Linux Mint, Debian, Ubuntu Server or Raspberry Pi OS. Set up everything with the Run first script explains each step.

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

Step 5, with a browser: create your password and set up

On a computer with a desktop, the set-up page opens by itself with the setup code filled in. With no desktop, open the address the installer printed on a phone or another computer, and enter the setup code. Choose your password: follow Create your password and sign in. Starboard's set-up guide then asks what you want to watch, listen to and read.

It worked when Starboard opens its dashboard.

Step 5, terminal only: answer the set-up questions

The installer asks every question in the terminal: your password, your apps and your download hours. Press Enter for the recommended answer, b to go back and ? for help. Follow Set up Starboard in the terminal, with no browser.

It worked when the installer prints the addresses to open Starboard from any device later.

Step 6: Add your media apps

Choose what you want, such as films, series and audiobooks, and Starboard installs the apps and tells you how to connect them. If you chose your apps in step 5, they are already running: go on to connecting them. Follow Build a media server from nothing. The dashboard's Still to set up list shows what is left: read Finish what is still to set up.

It worked when you search for something, add it and find it in Activity, Downloads, Queue.

What next

This page on GitHub, where the help is written.