Backup & Restore¶

GeoJibe stores application state on disk. A backup must include the installation identity and license together with the database and configuration. Restoring only the database is not enough.

Warning

Do not copy a live SQLite database while GeoJibe is running. Stop the service or container first.

What to back up¶

Ubuntu / APT¶

Path	Contents
`/etc/enciva/enciva.env`	Installation settings, including the secret used to decrypt saved connections
`/var/lib/enciva`	Database, jobs, sync state, installation identity, and license

Docker¶

Path	Contents
`/var/lib/enciva`	`enciva.env`, database, jobs, sync state, installation identity, and license

The Docker data directory includes enciva.env. There is no separate /etc/enciva on the host for a standard Compose install.

A complete data-directory backup includes:

enciva.db and -wal / -shm if present
enciva.env (Docker) or /etc/enciva/enciva.env (APT)
installation-id
license.lic
jobs/, sync/, recipes/
enciva.secret if present

The secret key is required to restore encrypted saved connections. Setup does not print it.

Backup¶

Ubuntu / APT¶

sudo systemctl stop enciva
sudo cp -a /etc/enciva /var/backups/geojibe-etc-$(date +%Y%m%d)
sudo cp -a /var/lib/enciva /var/backups/geojibe-data-$(date +%Y%m%d)
sudo systemctl start enciva

Docker¶

docker compose stop geojibe
sudo cp -a /var/lib/enciva /var/backups/geojibe-$(date +%Y%m%d)
docker compose start geojibe

Restore¶

Restore the same paths you backed up. Keep the original installation identity and license. Do not run setup again to create a new installation unless those files are missing.

Ubuntu / APT¶

sudo systemctl stop enciva
sudo cp -a /var/backups/geojibe-etc-<date>/. /etc/enciva/
sudo cp -a /var/backups/geojibe-data-<date>/. /var/lib/enciva/
sudo systemctl start enciva

Docker¶

docker compose stop geojibe
sudo cp -a /var/backups/geojibe-<date>/. /var/lib/enciva/
docker compose start geojibe

After restore, sign in with the existing administrator account. Reactivation is not required when the restored identity and license are intact.