Updating
Update a self-hosted Savvy instance to the latest release with docker compose pull. Migrations run automatically and your data stays in the /data volume.
Updating Savvy is pulling a newer image and recreating the container. Migrations
run automatically on startup, and your data stays in the /data volume.
With a pinned tag (recommended)
The Installation compose file pins a specific release for
reproducible deploys. To upgrade, bump the image: tag to the current release —
shown live on the Get started page — then:
docker compose pull
docker compose up -dWith a floating tag
If you prefer to track the newest release without editing the file, set the
image to truenormis/savvy:latest in your compose file. Then the same two
commands always fetch the newest image:
docker compose pull
docker compose up -dThe trade-off: convenience versus reproducibility. A pinned tag tells you
exactly what's running and makes rollbacks trivial; latest keeps you current
but moves under you.
Your data is safe
Updates only replace the application image. Everything in the /data volume —
your SQLite database and uploads — is untouched. Still, take a
backup before a major upgrade.
Rolling back
Set the image: tag back to the previous release and run docker compose pull && docker compose up -d again. If a migration changed the schema, restore the
matching backup you took before upgrading.