On this page
Quick start: one command sets up everything
The quickest way to a working media server is the Run first script. Once Linux is on the computer, you run one command and it does the rest: it checks the computer, installs what is missing, downloads Starboard and starts the set-up, in your browser or in the terminal. It suits people who have set up servers before too: it checks every step, and you can change anything afterwards.
Before you begin
- A computer with Linux on it: Linux Mint 22.3 (recommended), Debian 13, Ubuntu Server 26.04 or Raspberry Pi OS (64-bit), or a later version. Each has its own page, such as Start Starboard on Debian. No Linux yet? Follow Get Starboard up and running, from a bare computer instead: it starts with installing Linux.
- The computer is connected to the internet, and you know the password you sign in to it with.
- About 15 minutes, most of it waiting for downloads.
The steps at a glance
- Open a terminal on the computer, or connect to it.
- Run the Run first script.
- Answer its questions, in the browser or in the terminal.
- Open Starboard.
The chart in words
Start: 1. Open a terminal
- Then: 2. Run the Run first script
- With a desktop: 3. Set up in the browser
- Then: 4. Open Starboard
- No desktop: 3. Set up in the terminal
- Then: go to 4. Open Starboard
- With a desktop: 3. Set up in the browser
The script chooses the way for step 3 by itself.
Step 1: Open a terminal
On a computer with a desktop, open the Terminal app. On a server with no desktop, sign in to it, or connect to it from your own computer. Read Open a terminal if this is new.
Step 2: Run the Run first script
Copy this command, paste it into the terminal and press Enter:
curl -fsSL https://raw.githubusercontent.com/TheMightyTRex/starboard/main/run-first.sh | bash
If the terminal says "Command 'curl' not found", use this one instead. A new Debian does not include curl:
wget -qO- https://raw.githubusercontent.com/TheMightyTRex/starboard/main/run-first.sh | bash
Enter a at its first question for accessible mode, which carries on through the whole set-up. The script explains
each step and asks before it installs anything. If Linux is still installing its own updates, it waits for them with
a progress bar. Read Set up everything with the Run first script for each question,
and If it does not work if something stops.
You know it worked when the script says Starboard is running and shows its address.
Step 3: Answer its questions
- With a desktop: the set-up opens in your browser by itself. Choose your password, then keep Basics (recommended). Follow Set up your dashboard after installing. Bigger installs are in Basics, Full install and Everything.
- No desktop: the same questions are asked in the terminal. Read Set up Starboard in the terminal, with no browser.
You know it worked when the set-up says your apps are starting.
Step 4: Open Starboard
Open the address the script showed, from the server or from a phone or laptop at home, and sign in. Your apps appear on the Apps page as they start, which can take a few minutes.
What next
- Set up your dashboard after installing
- Finish what is still to set up
- Choose a Usenet provider and add it, if you use Usenet
- Use Starboard away from home safely
- Already have Docker and want to do it by hand? Install Starboard with the installer. The Run first script does this for you, so most people never need it.
This page on GitHub, where the help is written.