On this page
Move Starboard to a new computer
This guide moves Starboard, with all your apps, keys, categories and settings, from one computer to another. It is for anyone replacing or rebuilding their server. It takes about 30 minutes.
There are two ways. A settings backup works between any two installs. Copying the data folder also keeps your password, history and alerts, and suits a like-for-like move. Read Things to note.
Before you begin
- Starboard still runs on the old computer, or you have a settings backup file from it.
- The new computer is ready for Starboard: What you need to run Starboard.
The steps at a glance
- Back up Starboard's settings on the old computer.
- Install Starboard on the new computer.
- Restore the backup on the new computer.
- Check your apps' addresses.
- Stop Starboard on the old computer.
The chart in words
Start: 1. Back up on the old computer
- Then: 2. Install on the new one
- Then: 3. Restore
- Then: 4. Check addresses
- Then: 5. Stop the old one
- Then: 4. Check addresses
- Then: 3. Restore
Step 1: Back up Starboard's settings on the old computer
Follow Download a backup to download the backup file. Keep it somewhere safe: it holds your apps' API keys.
Step 2: Install Starboard on the new computer
Follow Install Starboard on a Linux computer or Install Starboard on a Raspberry Pi, up to choosing a password. Read Create your password and sign in.
Step 3: Restore the backup on the new computer
In the set-up's How to start step, choose Restore a backup. Choose the backup file and enter the password you chose. The set-up then asks only what the backup does not hold, such as where your media goes and your VPN details, when the apps need installing again. In the terminal set-up, enter where the backup file is.
A backup from an older version of Starboard is brought up to date as it is restored. Your new password stays: a backup never holds the password. If you already finished the set-up, follow Restore from a file instead.
It worked when the Apps page shows your apps.
Step 4: Check your apps' addresses
If your apps moved too, or the new computer reaches them differently, their addresses may need changing. For any app that shows as not responding, follow An app shows as not responding.
Step 5: Stop Starboard on the old computer
When everything works on the new computer, follow Remove Starboard on the old one.
Things to note
Copying the data folder instead. Stop Starboard on both computers, copy the whole data folder from the
old Starboard folder into the new one, and start Starboard again. Everything comes across, including your
password and anyone who is signed in. If you are not sure how to copy folders between computers, use the
backup instead.
What next
- Find out what each app is using on the new computer.
- Get told when something goes wrong.
This page on GitHub, where the help is written.