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.