Back up the Hub or move it to another box

What a backup holds

• The Hub's identity: the private key every paired device trusts.
• Its pairings, its cameras with their passwords, its licence keypair, its remote access key and its settings.
• Not footage. Footage stays on the recording disk.
• Anyone holding the file can be this Hub. Keep it where you keep passwords, and delete copies you no longer need.

Back up from the Hub's page

1. 01Sign in to the Hub's page and open Overview. While the Hub has no cameras, the left rail calls it This Hub.
2. 02In MAINTENANCE, next to Back up this Hub, choose Back up.
3. 03Read Download a backup of this Hub? and choose Download.
4. 04The page says Backup started. The browser saves it as a .tar.gz.

Back up from the box

1. 01On the Hub machine, run: sudo /usr/local/bin/sehub backup --to <folder>. Without --to it writes to the current folder.
2. 02It prints Backed up hub <id> and Wrote <file>. The file is named after the Hub and the time, and only its owner can read it.

• It is safe while the Hub is running.

Move the Hub to another box

1. 01Back up the old Hub, as above.
2. 02Install the Hub on the new box: Install the Hub. Do not set it up.
3. 03On the new box, stop it: sudo systemctl stop sehub
4. 04Copy the backup file to the new box and run: sudo /usr/local/bin/sehub restore <file>
5. 05On the old box, stop the Hub for good: sudo systemctl disable --now sehub
6. 06On the new box, start it: sudo systemctl start sehub

• Paired devices do not pair again: the new box has the same identity.
• Never run two Hubs with the same identity at once.
• A restore refuses while the Hub is running. It also refuses a box whose Hub already has paired devices or cameras, unless you add --force. The Hub it replaces is moved aside, not deleted, and the restore says where.
• A backup made by a newer Hub needs that version installed first.

If it does not work

• SE-STA-019: the backup could not be written. Check the folder exists and has room.
• SE-STA-020: the restore was refused. Stop the Hub first, add --force to replace a Hub in use, or install the newer Hub version the message names.
• SE-STA-021: the file did not verify: it is not a Hub backup, it is damaged or altered, or a newer Hub made it. Make a new backup on the old box, or install the newer version.