Skip to Content
DocumentationGuidesBackup and restore

Backup and restore

When changing hardware or network infrastructure, it is sometimes necessary to migrate your install onto a new device. You can do so by following the following steps.

On your first server, navigate to the cihome folder and stop Companion Home:

cd /opt/cihome && docker compose down

Navigate to the parent directory and create an archive of the cihome folder:

cd /opt && tar -czvf cihome.tar.gz --exclude='cihome/media' --exclude='cihome/repos' --exclude='cihome/backups' cihome

Send the archive to your second server. For example, using magic-wormhole . On your second server, extract the archive where you want the folder to live:

cd /opt && tar -xzvf cihome.tar.gz -C .

Start Companion Home on your second server:

cd /opt/cihome && docker compose up -d

Make sure you have Docker installed on your second server before starting Companion Home. An easy way to do so is to install a clean Companion Home instance on your second server, then stop it and replace the cihome folder with the one you just extracted.

You’re ready to go! Make sure any shared folder or manual network config you may have performed on your first server is re-applied again on your new server.

Last updated on