Prerequisites
- Fly.io account and organization
- Existing Fly app
flyctlinstalled and authenticated- Base values from Environment Variables
- A storage profile from Manual Installation Overview
Deploy flow
1
Configure secrets and variables
Set all required runtime values in Fly.io using the dashboard or
flyctl secrets set.2
Deploy an immutable image
Deploy the application image with
infra/fly/fly.toml.3
Run database migrations
Run
pnpm db:push from a secured environment connected to the production database before opening traffic to a new schema.4
Verify the release
Confirm the Fly health checks pass, open
SITE_URL, and sign in with an admin wallet.5
Plan rollback before production traffic
Keep the previous healthy digest ready so you can redeploy it quickly if needed.
Scheduler
Fly.io deployment does not replace the sync scheduler requirement. If the suppliedpg_cron jobs are not active in your database, implement Scheduled Jobs with an external scheduler such as GitHub Actions or Cloud Scheduler.