Self-Hosting

Updating

Keep your Retrospend instance up to date with the latest images.

Standard Update

Pull the latest images and restart the stack:

bashbash

docker compose pull
docker compose up -d

Database migrations run automatically on startup via the entrypoint script. Downtime is typically under 30 seconds.

Back up before upgrading

Always snapshot your postgres_data volume before a major update. Run docker exec retrospend-postgres pg_dump -U postgres retrospend > backup-$(date +%Y%m%d).sql before pulling.

Automatic Updates with Watchtower

Watchtower can automatically pull and redeploy updated images on a schedule:

docker-compose.yml (addition)yaml

services:
  # ... your existing services ...

  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      WATCHTOWER_CLEANUP: "true"
      WATCHTOWER_SCHEDULE: "0 0 4 * * *"  # Daily at 4 AM

Warning

Watchtower restarts containers automatically, which may cause brief downtime. Consider running it during off-peak hours.

Check Current Version

bashbash

docker inspect synzeit/retrospend:latest | grep -i version

Reverse Proxy

Environment Variables