How-to
Add a disk to the pool
Add a disk to the pool so its space joins /mnt/pool, or make the pool from your first disk. If the idea is
new, read What a disk pool is.
Before you begin
- The pool helper is set up. Run
./install.shagain and answer Yes to Set up Disk pools? The installer asks for your computer's password, because changing disks needs administrator rights. You enter it in the terminal yourself. - The computer has mergerfs, rsync and gdisk. On Debian, Ubuntu and Linux Mint, this command installs them:
sudo apt install mergerfs rsync gdisk
- The new disk is plugged in. Note the last 4 characters of its serial number, from the label on the disk.
- Have your Starboard password ready. Every change to the disks asks for it again.
- If the disk has files you want and you are going to erase it, copy them somewhere else first.
Steps
- Go to System, then Storage, then Pool.
- Select Add a disk.
- Choose a disk: select the disk. Check the end of its serial number against the label on the disk.
- Select Continue to What it is for.
- Under Use it, select Add it to the pool (recommended). For a backup disk instead, read Use a disk as a backup disk.
- Under What is on it now, select one: - Keep its files: its files appear in the pool as they are. Only offered when the disk has files. - Erase it and prepare it (ext4): everything on the disk is erased.
- Select Continue to Check. The pool helper checks the plan on the server. Nothing has changed yet.
- Read Check before anything changes. It lists every change, in order. To read the commands, select The exact commands.
- Select Continue to Confirm.
- If the disk is being erased, enter the last 4 characters of its serial number.
- In Enter your password, enter your Starboard password.
- Select Add the disk, or Erase and add to the pool.
- Wait while each step is ticked off. When it says Finished, select Back to Pool.

Things to note
- The check is good for 15 minutes. After that, or if the disk changed in the meantime, the helper stops with nothing changed, and you check again.
- Files already in the pool stay where they are. New files go to the disk with the most free space, so a new disk fills first. To even the disks out now, read Balance the files.
- The first disk makes the pool. Starboard also makes Docker wait for the pool when the computer starts, so the apps never run against an empty folder.
- Before it changes anything, the helper saves a copy of
/etc/fstabin/var/lib/starboard-pool/saved. It changes only its own lines there, between# starboard-pool beginand# starboard-pool end. - A pool made outside Starboard is shown on the Pool page, but Starboard does not change it.
- In the terminal:
./install.sh --terminalasks the same questions in its Your disks step. Read Set up in the terminal.
If it does not work
- The pool helper is not set up: answer Yes to Set up Disk pools? in
./install.sh. - My disk is not listed: Other disks on the Pool page says why each disk is not offered. Starboard
never offers the system disk, a disk in another pool, RAID or LVM, or a disk with no stable name in
/dev/disk/by-id. Some USB cases do not give one. - The disk changed since the check: something else used the disk. Select Back, then check again.
- Install these first: the message names the programs to install. Install them, then try again.
- /etc/fstab already mounts this disk: take that line out of
/etc/fstabfirst, or keep the disk's files instead of erasing it.
Find out more
This page on GitHub, where the help is written.