Fly.io Deployment & Management

Core Concepts

Fly App: Named group of Machines (VMs) + config + networking + secrets belonging to one org
Fly Machine: Fast-launching VM (sub-second start). Ephemeral root filesystem. Lifecycle: created -> started -> stopped -> destroyed
Fly Volume: NVMe-backed persistent storage, 1:1 with a Machine, region-pinned, encrypted at rest by default
Fly Proxy: Edge proxy handling TLS termination, load balancing, autostop/autostart, HTTP routing
flyctl (fly): CLI for all Fly.io operations. Install: brew install flyctl or curl -L https://fly.io/install.sh | sh
fly.toml: App configuration file. See references/fly-toml-config.md for complete reference

# 1. Create app + fly.toml
fly launch

# 2. Set secrets
fly secrets set DATABASE_URL=postgres://... SECRET_KEY=...