Fly.io Deployment (flyctl)

Deploy applications to Fly.io's global edge infrastructure.

Quick Reference

Core Workflows

1. New App Deployment

cd /path/to/project
fly launch              # Interactive setup
fly launch --now -y     # Accept defaults, deploy immediately
fly launch --no-deploy  # Configure only, deploy later

Creates: fly.toml (config), Dockerfile (if needed)

2. Subsequent Deploys

fly deploy                    # Standard deploy
fly deploy --strategy rolling # Rolling update (default)
fly deploy --local-only       # Build locally instead of remote

3. Secrets Management

fly secrets set KEY=value           # Set secret
fly secrets set K1=v1 K2=v2        # Multiple
fly secrets list                    # List (values hidden)
fly secrets unset KEY               # Remove
cat .env | fly secrets import       # Import from file

4. Scaling

fly scale show                      # Current config
fly scale vm shared-cpu-1x          # Change VM size
fly scale memory 512                # Set memory (MB)
fly scale count 3                   # Set instance count
fly scale count web=2 worker=1      # Per process group

VM sizes: shared-cpu-1x, shared-cpu-2x, performance-1x, performance-2x

5. Volumes (Persistent Storage)

fly volumes create mydata --size 10 --region ord  # Create 10GB
fly volumes list                                   # List volumes
fly volumes extend <id> --size 20                  # Resize

Mount in fly.toml:

[mounts]
source = "mydata"
destination = "/data"

6. Databases

Managed Postgres (recommended):

fly mpg create                      # Create managed postgres
fly mpg list                        # List clusters

Unmanaged Postgres:

fly postgres create                 # Create cluster
fly postgres attach <pg-app>        # Attach to app (sets DATABASE_URL)
fly postgres connect <pg-app>       # Connect via psql

Redis (Upstash):

fly redis create                    # Create instance

7. Monitoring

fly status                # App status
fly logs                  # Tail logs
fly logs -i <machine-id>  # Specific machine
fly checks list           # Health checks
fly dashboard             # Open web UI

8. SSH & Console

fly ssh console           # Interactive shell
fly ssh console -C "cmd"  # Run command
fly sftp shell            # SFTP access

fly.toml Essentials

app = "my-app"
primary_region = "ord"

[env]
APP_ENV = "production"

[http_service]
internal_port = 8080
force_https = true
auto_stop_machines = "stop"
auto_start_machines = true
min_machines_running = 1

[[vm]]
memory = "512mb"
cpu_kind = "shared"
cpus = 1

Framework-Specific

For Laravel apps: Read reference/laravel.md For Dockerfile apps: Read reference/dockerfile.md

Troubleshooting

fly doctor              # Diagnose issues
fly releases            # List releases
fly releases show <v>   # Release details
fly machine list        # List machines
fly machine restart <id> # Restart specific machine

Common Flags