| name | fly-cli |
| description | Use the Fly.io CLI (flyctl) to deploy applications to edge locations, manage machines, volumes, secrets, and databases. |
Fly.io CLI (flyctl / fly)
Official CLI for Fly.io. Deploy apps globally to edge locations with Firecracker VMs.
Authentication
fly auth login
fly auth token
fly auth whoami
Common Commands
Apps
fly launch
fly deploy
fly deploy --image my-registry/my-app:v1
fly apps list
fly status
fly open
Machines
fly machine list
fly machine start MACHINE_ID
fly machine stop MACHINE_ID
fly machine restart MACHINE_ID
fly machine status MACHINE_ID
Scaling
fly scale count 3
fly scale vm shared-cpu-1x
fly scale memory 512
fly scale show
fly regions add ord
fly regions list
Secrets
fly secrets set DATABASE_URL=postgres://...
fly secrets list
fly secrets unset DATABASE_URL
Logs and SSH
fly logs
fly ssh console
fly ssh console -C "ls /app"
Databases
fly postgres create
fly postgres list
fly postgres connect -a my-db
Volumes
fly volumes create my_data --size 10
fly volumes list
Agent Best Practices
- Use
fly status to check app health and deployment status
- Use
fly deploy --strategy rolling for zero-downtime deploys
- Use
fly logs to debug issues after deployment
- Set secrets before deploying:
fly secrets set triggers a redeploy
- Use
fly ssh console -C "command" for one-off remote commands
- Use
fly scale count to manage instance count per region
Example Workflows
Deploy and verify
fly deploy
fly status
fly logs --instance INSTANCE_ID
Scale to multiple regions
fly regions add lax ord ams
fly scale count 2