LinuxCommandLibrary

fly

Interact with Concourse CI pipelines

TLDR

Authenticate with and save concourse target

$ fly [[-t|--target]] [target_name] login [[-n|--team-name]] [team_name] [[-c|--concourse-url]] [https://ci.example.com]
copy

List targets
$ fly targets
copy

List pipelines
$ fly [[-t|--target]] [target_name] pipelines
copy

Upload or update a pipeline
$ fly [[-t|--target]] [target_name] set-pipeline [[-c|--config]] [pipeline.yml] [[-p|--pipeline]] [pipeline_name]
copy

Unpause pipeline
$ fly [[-t|--target]] [target_name] unpause-pipeline [[-p|--pipeline]] [pipeline_name]
copy

Show pipeline configuration
$ fly [[-t|--target]] [target_name] get-pipeline [[-p|--pipeline]] [pipeline_name]
copy

Update local copy of fly
$ fly [[-t|--target]] [target_name] sync
copy

Destroy pipeline
$ fly [[-t|--target]] [target_name] destroy-pipeline [[-p|--pipeline]] [pipeline_name]
copy

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.

SEE ALSO

docker(1), ssh(1), curl(1)

Copied to clipboard