innozverse-flyio-deploy

Deploy the innozverse API to Fly.io, manage deployments, check status, view logs, and troubleshoot deployment issues. Use when deploying the API or debugging Fly.io deployment problems.

innozverse Fly.io Deployment Skill

Quick reference for deploying the innozverse API to Fly.io.

Prerequisites

brew install flyctl  # macOS
fly auth login

First Deployment

cd apps/api
fly launch  # Follow prompts
fly secrets set API_VERSION=1.0.0
fly deploy

Subsequent Deployments

cd apps/api
fly deploy

Common Commands

fly status              # Check app status
fly logs                # View logs
fly ssh console         # SSH into machine
fly secrets set KEY=val # Set environment variable
fly scale memory 512    # Scale memory
fly open                # Open app in browser

Configuration (fly.toml)

Located at apps/api/fly.toml:

app: App name on Fly.io
internal_port: 8080 (must match PORT in code)
auto_stop_machines: Scale to zero when idle
Health check: /health endpoint

Troubleshooting

Build fails: Check Dockerfile, verify dependencies Health check fails: Test /health endpoint locally Connection issues: Check fly status, verify region

Resources

See docs/deployment-flyio.md for full guide.