# Install flyctl with Homebrew, chocolatey, MacPorts, Nix, scoop, winget, zypper Command-line tools for fly.io services. Version 0.4.68 via Homebrew; verified 2026-07-08. ## Install ```sh sudo av install brew:flyctl ``` ## Agent safety answer flyctl deploys and manages Fly.io applications and infrastructure. - **Credential access:** Reads Fly tokens, app config, secrets, and environment variables. - **Remote mutation:** Can deploy, scale, destroy, and change remote app state. - **Publish/artifact risk:** Publishes application images and release configuration. - **Recommended control:** Gate deploy, secrets, scale, destroy, and token commands. - **Agent-use guidance:** Allow status and config reads; require approval for deploys, secret changes, and destructive operations. Additional install commands: ### macOS - Homebrew (100%): ```sh brew install flyctl ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install flyctl ``` Evidence: MacPorts ports tree: devel/flyctl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#flyctl ``` Evidence: nixpkgs package indexes: pkgs/by-name/fl/flyctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install fly ``` Evidence: openSUSE Tumbleweed package metadata: fly from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Chocolatey (92%): ```sh choco install flyctl ``` Evidence: Chocolatey community package catalog: flyctl from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','flow-launcher' - Scoop (92%): ```sh scoop install main/flyctl ``` Evidence: Scoop official bucket manifest trees: bucket/flyctl.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id Fly-io.flyctl -e ``` Evidence: Windows Package Manager source index: Fly-io.flyctl from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:flyctl - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.4.68 - **Source summary:** Command-line tools for fly.io services - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-08T20:50:21Z - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - fly (cli) - flyctl (cli) - fly (alias) - flyctl (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-09 - Package-manager version: 0.4.68 - Package-manager updated: 2026-07-08 - Local data: ok - Upstream repository: https://github.com/superfly/flyctl - info: No cached GitHub release or tag data was available. ## Project history and usage flyctl is the official Fly.io command-line interface, installed locally and invoked as fly to create, deploy, and manage applications on Fly.io. ### Project history Fly.io documentation presents flyctl as one of the primary ways to interact with the Fly.io platform. The CLI covers account login, app launch and deployment, Machines, volumes, networking, certificates, logs, secrets, organizations, SSH, WireGuard, and related platform operations. The public superfly/flyctl repository is the source-control home for the CLI and has been released as a versioned Go command-line tool since early public releases in 2019. ### Adoption history flyctl adoption follows Fly.io's platform adoption: it is the documented entry point for launching apps, deploying services, managing infrastructure primitives, and automating CI workflows. Official install docs include Homebrew on macOS, shell install scripts on Unix-like systems, and a PowerShell installer on Windows. ### How it is used Users run fly auth login or signup, fly launch, fly deploy, fly logs, fly status, fly secrets, fly machine, fly volumes, fly certs, and related commands to manage apps and infrastructure from local terminals or CI jobs. ### Why package nerds care flyctl is package-nerd significant as a fast-moving cloud CLI: package managers need to track frequent upstream releases, expose both fly and flyctl entry points, and preserve a simple install path for users who bootstrap deployments from a fresh workstation or CI image. It is also a good example of modern PaaS packaging, where the CLI is not just a helper but the main control plane surface for app creation, deployment, credentials, and operational introspection. ### Timeline - 2019: flyctl v0.0.1 was published. - 2020: flyctl continued through frequent v0.0.x releases as Fly.io's CLI matured. - 2022: Fly Machines and related infrastructure commands became part of the CLI surface. - 2026: Fly.io documentation lists flyctl as the primary local CLI for apps, Machines, volumes, networking, and more. ### Related projects - Fly.io Machines, Fly Launch, Fly Deploy, LiteFS Cloud, Managed Postgres, WireGuard networking, and Tigris storage are platform areas exposed through flyctl commands. - The Fly.io docs site and the superfly/flyctl GitHub repository are the main related official project surfaces. ### Sources - - - - ## Security Notes No matching local secret-handling manifest was found for flyctl. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.fly/config.yml ## Credential files - Unix: ~/.fly/config.yml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** flyctl - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - flyctl: normalized package name match | nixpkgs package indexes: pkgs/by-name/fl/flyctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - flyctl: normalized package name match | MacPorts ports tree: devel/flyctl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Chocolatey - flyctl: normalized package name match | Chocolatey community package catalog: flyctl from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','flow-launcher' - Scoop - main/flyctl: normalized package name match | Scoop official bucket manifest trees: bucket/flyctl.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - Fly-io.flyctl: normalized package name match | Windows Package Manager source index: Fly-io.flyctl from https://cdn.winget.microsoft.com/cache/source.msix - Nix - fly: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/fl/fly/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper - fly - 2.0.1-2.6: installed executable or alias match | openSUSE Tumbleweed package metadata: fly from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | A Script to Create PNGs | http://martin.gleeson.com/fly/ ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [convox](https://www.automicvault.com/pkg/brew/convox/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, deployment, paas. - [heroku](https://www.automicvault.com/pkg/brew/heroku/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, deployment, paas. - [railway](https://www.automicvault.com/pkg/brew/railway/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, deployment, paas. - [scalingo](https://www.automicvault.com/pkg/brew/scalingo/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, deployment, paas. - [aws-elasticbeanstalk](https://www.automicvault.com/pkg/brew/aws-elasticbeanstalk/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment, paas. - [emp](https://www.automicvault.com/pkg/brew/emp/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment, paas. - [firebase-cli](https://www.automicvault.com/pkg/brew/firebase-cli/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, deployment. - [render](https://www.automicvault.com/pkg/brew/render/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, deployment. ## Combined YAML source View the package source record on GitHub. [combined/flyctl.yml](https://github.com/automic-vault/db/blob/main/combined/flyctl.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer