browse
flyctl/Fly.io CLI
Fly.ioCommand line interface for deploying and managing applications on the Fly.io platform.
Cloud ProvidersJSON
01Install
brew install flyctl02Agent Notes
flyctl uses `fly <command>` (alias for flyctl). Always pass `--json` for machine output. Key commands: deploy, status, scale, secrets, logs. Use `--app` or set FLY_APP to target an app. Config file is fly.toml in project root.
03Help Output
This is flyctl, the Fly.io command line interface.
Usage:
flyctl [flags]
flyctl [command]
Deploying apps & machines
apps Manage apps.
deploy Deploy Fly applications
launch Create and configure a new app from source code or a Docker image
machine Manage Fly Machines.
status Show app status
Configuration & scaling
certs Manage certificates
config Manage an app's configuration
image Manage app image
ips Manage IP addresses for apps
scale Scale app resources
secrets Manage application secrets with the set and unset commands.
volumes Manage Fly Volumes.
Monitoring & managing things
checks Manage health checks
console Run a console in a new or existing machine
dashboard Open web browser on Fly Web UI for this app
dig Make DNS requests against Fly.io's internal DNS server
incidents Show incidents
logs View app logs
mcp flyctl Model Context Protocol.
ping Test connectivity with ICMP ping messages
proxy Proxies connections to a Fly Machine.
releases List app releases
services Show the application's services
sftp Get or put files from a remote VM.
ssh Use SSH to log into or run commands on Machines
wireguard Commands that manage WireGuard peer connections
Databases & extensions
consul Enable and manage Consul clusters
extensions Extensions are additional functionality that can be added to your Fly apps
litefs-cloud LiteFS Cloud management commands
mpg Manage Managed Postgres clusters.
mysql Provision and manage MySQL database clusters
postgres Unmanaged Postgres cluster commands
redis Launch and manage Redis databases managed by Upstash.com
storage Provision and manage Tigris object storage buckets
Access control
auth Manage authentication
orgs Commands for managing Fly organizations
tokens Manage Fly.io API tokens
Help & troubleshooting
docs View Fly documentation
doctor The DOCTOR command allows you to debug your Fly environment
platform Fly platform information
Additional Commands:
agent Commands that manage the Fly agent, a background process that manages flyctl wireguard connections
completion Generate the autocompletion script for the specified shell
help Help about any command
jobs Show jobs at Fly.io
settings Manage flyctl settings
synthetics Synthetic monitoring
version Show version information for the flyctl command
Flags:
-t, --access-token string Fly API Access Token
--debug Print additional logs and traces
-h, --help help for flyctl
--verbose Verbose output
-v, --version version for flyctl
Use "flyctl [command] --help" for more information about a command.
04Global Flags
| Flag | Type | Description |
|---|---|---|
--app/-a | string | Application name to operate on |
--json | boolean | Output results as JSON |
--verbose | boolean | Verbose output |
05Authentication
Methods
access-tokenenvironment-variables
Env vars
FLY_ACCESS_TOKENFLY_APPConfig files
~/.fly/config.ymlSetup
flyctl auth login06Capabilities
Reference
binary
flyctlcheck
flyctl versionauth
access-token, environment-variablesformats
text, jsonjson flag
--jsonversion
0.4.21