Skill

flyio-core-workflow-a

Deploys, scales, and manages Fly.io apps: configure fly.toml, run flyctl for secrets/regions/lifecycle, handle Docker builds and multi-region scaling.

Docker

Bash

deployment

devops

npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin flyio-pack

Tool Access

This skill is limited to using the following tools:

ReadWriteEditBash(fly:*)Bash(curl:*)Grep

Preview

The primary Fly.io workflow: configure `fly.toml`, deploy apps, manage secrets, scale across regions, and control machine lifecycle.

SKILL.md

Similar Skills

flyio

Deploys and manages Fly.io apps using Docker containers, Fly Machines, fly.toml configs, databases, volumes, secrets. Supports fly launch/deploy, debugging, multi-region setups for Python/Node/Rails/Django apps.

6 files

bbrewington-tools

Fly.io Infrastructure Skills

Provides quick reference for Fly.io PaaS deployments including fly.toml config, global distribution, scaling patterns, secrets management, health checks, and troubleshooting. Auto-loads on fly.toml detection.

20 files

fortiumpartners-ai-mesh

flyio-hello-world

1.9k

Deploys hello world apps to Fly.io via flyctl launch CLI or Machines API. For new projects, global containers, and edge compute testing.

6 tools

flyio-pack

Stats

Parent Repo Stars1854

Parent Repo Forks248

Last CommitMar 22, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Fly.io Core Workflow A: Deploy & Scale

Overview

The primary Fly.io workflow: configure fly.toml, deploy apps, manage secrets, scale across regions, and control machine lifecycle.

Instructions

Step 1: Configure fly.toml

# fly.toml — app configuration
app = "my-app"
primary_region = "iad"

[build]
  dockerfile = "Dockerfile"

[env]
  NODE_ENV = "production"
  PORT = "3000"

[http_service]
  internal_port = 3000
  force_https = true
  auto_stop_machines = "stop"    # Stop idle machines
  auto_start_machines = true     # Start on request
  min_machines_running = 1       # Always keep 1 warm

[http_service.concurrency]
  type = "requests"
  hard_limit = 250
  soft_limit = 200

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

Step 2: Deploy and Manage Secrets

# Set secrets (encrypted, injected as env vars)
fly secrets set DATABASE_URL="postgres://..." API_KEY="sk_..."

# List secrets (values hidden)
fly secrets list

# Deploy
fly deploy

# Check deployment status
fly status
fly releases

Step 3: Scale Across Regions

# Add machines in new regions
fly scale count 2 --region iad    # 2 machines in Virginia
fly scale count 1 --region lhr    # 1 machine in London
fly scale count 1 --region nrt    # 1 machine in Tokyo

# Adjust VM size
fly scale vm shared-cpu-2x --memory 1024

# Check current scale
fly scale show

Step 4: Manage App Lifecycle

# Restart all machines
fly apps restart

# Suspend an app (stop billing)
fly apps suspend my-app

# Resume
fly apps resume my-app

# Destroy (irreversible)
fly apps destroy my-app --yes

fly.toml Key Settings

Setting	Default	Recommended
`auto_stop_machines`	`"stop"`	`"stop"` for most, `"suspend"` for fast resume
`auto_start_machines`	`true`	`true` for HTTP services
`min_machines_running`	`0`	`1` for production (avoid cold starts)
`concurrency.soft_limit`	`200`	Tune based on app capacity

Error Handling

Error	Cause	Solution
`failed to build`	Dockerfile issue	Test locally: `docker build .`
`health check failed`	App not responding on internal_port	Verify port matches app config
`no machines running`	All stopped	Set `min_machines_running = 1`

Resources

Next Steps

For Postgres and volumes, see flyio-core-workflow-b.