# Upgrade Guide

1. Read release notes.
2. Back up PostgreSQL and secrets.
3. Pull the new version.
4. Run database migrations.
5. Restart API, workers, frontend, and proxy.
6. Run health checks.
7. Generate a firewall preview before any apply workflow.