fly
Interact with Concourse CI pipelines
TLDR
Authenticate with and save concourse target
List targets
List pipelines
Upload or update a pipeline
Unpause pipeline
Show pipeline configuration
Update local copy of fly
Destroy pipeline
SYNOPSIS
fly [global-options...] <command> [<args>]
PARAMETERS
-a, --app <NAME>
Specify application by name
-c, --config <PATH>
Path to fly.toml config file
-h, --help
Show help for fly
--verbose
Enable verbose logging
--json
Enable JSON output
-i, --interactive
Interactive mode
--log-level <LEVEL>
Set log level (debug,info,warn,error)
DESCRIPTION
The fly command is the official CLI tool for the Fly.io platform, a global cloud hosting service focused on running containerized applications close to users via an anycast network of edge servers. It enables developers to launch, deploy, scale, and manage apps effortlessly without dealing with traditional cloud complexities like regions or load balancers.
Fly.io uses Firecracker microVMs for secure isolation and supports Dockerfiles natively. Key workflows include signing up via fly auth signup, launching an app with fly launch (which generates a fly.toml config), and deploying with fly deploy. It handles global routing, SSL, metrics, logs, and secrets seamlessly.
Designed for web apps, APIs, and workers, fly integrates with GitHub Actions for CI/CD and supports custom domains, volumes, Postgres, Redis via Fly Postgres/Redis services. It's lightweight, fast, and emphasizes developer experience with commands for SSH access, scaling machines, and monitoring performance across 35+ regions worldwide.
CAVEATS
Not a core Linux utility; must be installed separately. Requires Fly.io account and internet. Subcommands have additional flags; use fly <command> --help for details.
INSTALLATION
curl -L https://fly.io/install.sh | sh
Or brew install flyctl on macOS.
COMMON SUBCOMMANDS
fly auth login: Authenticate
fly launch: Create new app
fly deploy: Deploy code
fly status: App status
fly open: Open app URL
HISTORY
Released in 2020 with Fly.io public beta. Evolved from flyctl; rebranded to fly in 2022. Key updates include Machines API (2022), Postgres support, and WireGuard integration for private networking.


