flyctl
Deploy and manage apps on Fly.io using flyctl CLI. Triggers on: fly deploy, fly.io, flyctl, deploy to fly. Handles launch, deploy, scale, secrets, volumes, databases.
How do I install this agent skill?
npx skills add https://github.com/sebastiaanwouters/dotagents --skill flyctlIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides documentation and command references for using the Fly.io CLI (flyctl) to manage application deployments. It contains no executable code or scripts, focusing entirely on guiding an agent through standard operational tasks such as scaling, secret management, and logging. No security issues or malicious patterns were detected.
- Socketpass
No alerts
- Snykfail
Risk: HIGH · No issues
- Runlayerfail
3/3 files flagged
What does this agent skill do?
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 |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/sebastiaanwouters/dotagents/flyctl">View flyctl on skillZs</a>