Fly.io Deployment (flyctl)

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

Quick Reference

Task	Command
New app	fly launch
Deploy	fly deploy
Status	fly status
Logs	fly logs
SSH	fly ssh console
Open	fly apps open

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

Flag	Description
-a <app>	Specify app name
-c <path>	Config file path
-r <region>	Target region
--yes	Skip confirmations
--verbose	Verbose output