Skip to content

Upgrading

Hora stores everything in one SQLite file; schema migrations are embedded in the binary and applied automatically on startup. Upgrading is: replace the binary (or image), restart.

Terminal window
docker pull ghcr.io/uplg/hora:latest
docker stop hora && docker rm hora
docker run -d --name hora --restart unless-stopped \
-p 8787:8787 \
-v "$PWD/hora-config:/etc/hora" \
-v hora-data:/data \
ghcr.io/uplg/hora:latest

Your history lives on the hora-data volume and survives upgrades.

Behavioural changes that may need operator attention are documented in UPGRADES.md - for example, 0.4.1 tightened security defaults (empty access tokens fail startup) and 0.4 itself was a no-breaking-changes upgrade. The full history is in the CHANGELOG.

A consistent snapshot of the database is one command, safe while the daemon runs:

Terminal window
hora backup /backups/hora-pre-upgrade.db