Fly.io Skill

Fly.io is managed via the flyctl CLI (alias: fly) and the Machines REST API.

Auth

fly auth login          # opens browser
fly auth token          # print current token
export FLY_API_TOKEN=$(fly auth token)

App Management

fly apps list                          # list all apps
fly status -a \x3Capp-name>               # app health + machine states
fly info -a \x3Capp-name>                 # app details, IPs, regions
fly open -a \x3Capp-name>                 # open in browser

Deploy

fly deploy                             # deploy from current dir (uses fly.toml)
fly deploy --image registry/image:tag  # deploy a specific image
fly deploy --remote-only               # build remotely (no local Docker needed)
fly deploy -a \x3Capp-name>               # target specific app

Logs

fly logs -a \x3Capp-name>                 # live log stream
fly logs -a \x3Capp-name> --no-tail       # recent logs, no follow

Secrets

fly secrets set MY_KEY=value -a \x3Capp-name>
fly secrets list -a \x3Capp-name>
fly secrets unset MY_KEY -a \x3Capp-name>

Scaling

fly scale count 3 -a \x3Capp-name>                    # set machine count
fly scale memory 512 -a \x3Capp-name>                 # set RAM (MB)
fly scale vm shared-cpu-2x -a \x3Capp-name>           # change VM size
fly scale show -a \x3Capp-name>                        # current scale

Machines

fly machine list -a \x3Capp-name>
fly machine status \x3Cmachine-id> -a \x3Capp-name>
fly machine restart \x3Cmachine-id> -a \x3Capp-name>
fly machine stop \x3Cmachine-id> -a \x3Capp-name>
fly machine destroy \x3Cmachine-id> -a \x3Capp-name>

Run a Command (one-off)

fly ssh console -a \x3Capp-name>                      # interactive shell
fly ssh console -a \x3Capp-name> -C "ls -la /app"    # run single command

Postgres

fly postgres create --name myapp-db                # create Postgres cluster
fly postgres connect -a myapp-db                   # psql shell
fly postgres attach myapp-db -a \x3Capp-name>         # attach DB to app (sets DATABASE_URL)

VM Sizes

shared-cpu-1x (256MB), shared-cpu-2x (512MB), performance-1x (2GB), performance-2x (4GB)

Regions

iad (Virginia), ord (Chicago), lax (LA), sea (Seattle), ams (Amsterdam), fra (Frankfurt), sin (Singapore), syd (Sydney)

Tips

• fly.toml is the app config — always check it before deploying
• fly deploy --strategy rolling for zero-downtime deploys
• Health checks in fly.toml under [checks] block