Skip to content

Upgrading and backups ​

Upgrading ​

  1. Back up your data.
  2. Update the source code to the new version (for example with git pull).
  3. Rebuild and restart:
bash
docker compose up -d --build

Database 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.sql

Also 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.

  1. Start only the database:
bash
docker compose up -d db
  1. Load the backup:
bash
docker compose exec -T db psql -U openscrum openscrum < openscrum-backup.sql
  1. Start the app:
bash
docker compose up -d