Engineering Guides
Software DevelopmentCloud EngineeringAI Engineering (soon)
Setup

Fly CLI (flyctl)

Install and authenticate the Fly CLI used for app and infrastructure management.

When to use this page

  • You need local CLI access to manage Fly apps, databases, and secrets.
  • You are preparing local environment for the default deployment path.

Prerequisites

  • Terminal access on your local machine or development environment.
  • Fly.io account ready for authentication.

Install

Quick Install

macOS (Homebrew)

brew install flyctl

Linux / WSL

curl -L https://fly.io/install.sh | sh

Authentication

After installing, authenticate with your Fly.io account:

fly auth login

Verify

fly version
fly auth whoami

You should see a valid CLI version and your authenticated Fly account.

Troubleshooting

  • fly command not found: Reopen terminal or ensure install path is in PATH.
  • Authentication fails: Retry login and confirm browser/session allows Fly auth callback.

Cloudflare Account

Create Cloudflare account and organization access for DNS and Workers.

Wrangler CLI

Install and authenticate Wrangler for Cloudflare Workers deployment.

On this page

When to use this pagePrerequisitesInstallQuick InstallmacOS (Homebrew)Linux / WSLAuthenticationVerifyTroubleshooting