browse
flyctl/

Fly.io CLI

Fly.io

Command line interface for deploying and managing applications on the Fly.io platform.

Cloud ProvidersJSON
01Install
brew install flyctl

02Agent 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
FlagTypeDescription
--app/-astringApplication name to operate on
--jsonbooleanOutput results as JSON
--verbosebooleanVerbose output

05Authentication
Methods
access-tokenenvironment-variables
Env vars
FLY_ACCESS_TOKENFLY_APP
Config files
~/.fly/config.yml
Setupflyctl auth login

06Capabilities
Reference
binaryflyctl
checkflyctl version
authaccess-token, environment-variables
formatstext, json
json flag--json
version0.4.21