On this page
How-to
Install Docker
Install Docker, the program that runs Starboard in its own sealed box, with a few commands in the terminal. At the
end, docker compose version prints a version number and you are ready to install Starboard.
Set up everything with the Run first script does all of this for you, and installs Starboard too. Use this page to do it by hand.
Before you begin
- A computer with Linux Mint 22.3, Debian 13, Ubuntu Server 26.04 or Raspberry Pi OS (64-bit), or a later version. Read The four systems.
- The password you use to sign in to that computer. The terminal asks for it.
- A terminal open on that computer. Read The terminal: entering commands.
- Not sure what Docker is? Read What Docker is.
Steps for Debian, Ubuntu Server and Raspberry Pi OS
- Download and run Docker's own install script. It asks for your password and takes a few minutes:
curl -fsSL https://get.docker.com | sh
- Let your user run Docker without
sudoevery time:
sudo usermod -aG docker $USER
- Sign out of the computer and sign back in. On a computer you reach over SSH (secure shell), close the connection and connect again. This makes step 2 take effect.
- Open a terminal again and check that Docker works:
docker compose version
It prints a line such as "Docker Compose version" and a number. Docker is ready.
Steps for Linux Mint
Docker's install script does not support Linux Mint, so install Docker from Mint's own software instead.
- Install Docker and Docker Compose. It asks for your password:
sudo apt install docker.io docker-compose-v2
When it asks "Do you want to continue?", enter y and press Enter.
- Let your user run Docker without
sudoevery time:
sudo usermod -aG docker $USER
- Sign out of the computer and sign back in.
- Open a terminal again and check that Docker works:
docker compose version
It prints a line such as "Docker Compose version" and a number. Docker is ready.
Things to note
- Adding your user to the
dockergroup gives it full control of Docker, which is the same as administrator control of the computer. Only do this for your own user account. - You only install Docker once. Updates to Docker come with the computer's normal software updates.
If it does not work
- "curl: command not found": the computer does not have curl, the tool that downloads the script. Install it, then run step 1 again:
sudo apt install curl
- "permission denied" when you run a docker command: you have not signed out and back in since step 2. Sign out, sign in, and try again. If it still happens, restart the computer.
- "docker: 'compose' is not a docker command": the Compose part of Docker is missing. On Linux Mint, run the install command in step 1 again. On the others, run Docker's install script again.
- On Linux Mint, "Unable to locate package docker-compose-v2": your copy of Mint is probably an older version. Update Mint to the newest version, then try again.
Find out more
This page on GitHub, where the help is written.