On this page

Install Starboard on a Raspberry Pi

This guide takes you from a new Raspberry Pi to Starboard open in your browser, with your own password. It is for anyone, including people who have never set up a Raspberry Pi. It takes about an hour, most of it waiting for downloads.

Before you begin

  • A Raspberry Pi 4 with 4 GB of memory or more for a whole media server; a Raspberry Pi 5 with 8 GB is recommended. Read Raspberry Pi and other small devices.
  • A microSD card of 32 GB or more, the official power supply for your Pi, and a way to connect it to your home network.
  • Another computer with a card reader, to prepare the card.
  • If the terminal is new to you, read The terminal: entering commands first.

The steps at a glance

  1. Prepare the Raspberry Pi's memory card.
  2. Connect to the Pi from your computer.
  3. Run the Run first script, which installs Docker and Starboard.
  4. Create your password and finish setting up.
Flow chart: 1. Prepare the card. The same chart is written out in words after it.1. Prepare the card2. Connect to the Pi3. Run the Run firstscript4. Create your password
The chart in words

Start: 1. Prepare the card

  • Then: 2. Connect to the Pi
    • Then: 3. Run the Run first script
      • Then: 4. Create your password

Step 1: Prepare the Raspberry Pi's memory card

Raspberry Pi Imager puts Raspberry Pi OS (64-bit) on the card. It also sets your user name, Wi-Fi and remote access before the Pi first starts. Follow Prepare a Raspberry Pi.

It worked when the Pi has started with the card in it and its green light has stopped flashing.

Step 2: Connect to the Pi from your computer

You do the rest from your own computer, with commands that run on the Pi. Follow Connect to your server from another computer. With a monitor and the desktop on the Pi, open its Terminal instead.

It worked when your terminal shows the Pi's name before the cursor, for example sam@starboard-pi.

Step 3: Run the Run first script

One command checks the Pi, installs Docker and anything else missing, downloads Starboard and starts its installer. Follow Start Starboard on Raspberry Pi OS.

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

Step 4: Create your password and finish setting up

On your computer or phone, open http://starboard-pi.local:8095, with your Pi's name in place of starboard-pi. Enter the setup code and choose a password: follow Create your password and sign in. If the name does not open, use the Pi's address instead: read Open Starboard from a phone or another computer.

It worked when Starboard opens its dashboard.

What next

This page on GitHub, where the help is written.