Upgrading and backups
Upgrading
- Back up your data.
- Update the source code to the new version (for example with
git pull). - Rebuild and restart:
bash
docker compose up -d --buildDatabase changes are applied automatically when the new version starts. There is no separate migration step.
Backing up
All OpenSCRUM data lives in the PostgreSQL database. To save a copy to a file:
bash
docker compose exec -T db pg_dump -U openscrum openscrum > openscrum-backup.sqlAlso keep a copy of your .env file. Without the same AUTH_SECRET, everyone is signed out after a restore.
Restoring
Restore into a fresh installation whose database is empty — that is, before the app has started for the first time.
- Start only the database:
bash
docker compose up -d db- Load the backup:
bash
docker compose exec -T db psql -U openscrum openscrum < openscrum-backup.sql- Start the app:
bash
docker compose up -d