Software Updates

Update Procedure

Pre-Update

1. Read the release notes for breaking changes
2. Back up the database before upgrading
3. Test in staging before production

Server Update

# Back up database
cp /data/vouch.db /data/vouch.db.pre-upgrade

# Update via package manager
sudo apt upgrade vouch-server    # Debian/Ubuntu
sudo dnf upgrade vouch-server    # RHEL/Fedora

# Or via Docker
docker pull ghcr.io/vouch-sh/vouch:latest
docker compose up -d

# Or via Helm
helm upgrade vouch-server oci://ghcr.io/vouch-sh/charts/vouch-server \
  --version <new-version> --namespace vouch

# Verify
curl -k https://auth.example.com/health

Database migrations run automatically on startup. No manual migration steps are needed.

Client Update

# macOS
brew upgrade vouch

# Linux
sudo apt upgrade vouch    # Debian/Ubuntu
sudo dnf upgrade vouch    # RHEL/Fedora

Rollback

To roll back:

1. Stop the server
2. Restore the database from the pre-upgrade backup
3. Install the previous version
4. Start the server

Database migrations have no rollback step — restoring the pre-upgrade backup is the rollback. Back up before upgrading.

Version Compatibility

• The server is backward-compatible with older CLI versions
• Upgrade the server first, then clients
• Release notes call out major versions that require simultaneous client updates

Release Channels