Skip to content
Documentation
Upgrading

Upgrading

Trove handles database migrations automatically on startup — there’s no manual migration step.

Docker Compose 

docker compose pull
docker compose up -d

This pulls the latest image and recreates the container. Downtime is typically a few seconds.

Docker (standalone) 

docker pull ghcr.io/agjmills/trove:latest
docker stop trove
docker rm trove
docker run -d --name trove ... # same flags as before

Manual (binary) 

git pull
go build -o trove ./cmd/server
./trove

Pinning a version

The latest tag always tracks the most recent release. To pin to a specific version:

image: ghcr.io/agjmills/trove:v1.2.3

Available tags are listed on the GitHub releases page.

Before upgrading

  • Back up your database. Migrations are applied automatically and are not reversible without a backup.
  • Back up your storage path (STORAGE_PATH) if using the disk backend.
  • Check the changelog for any breaking changes or new required environment variables.
Troubleshooting