flyio

# ✈️ Fly.io

Fly.io edge deployment platform — manage apps, machines, volumes, secrets, and certificates via the Fly.io Machines API.

## Features

- **App management** — create, list, configure apps
- **Machine operations** — start, stop, restart machines
- **Volume management** — persistent storage provisioning
- **Secret management** — secure environment secrets
- **Certificate management** — SSL/TLS auto-provisioning
- **Scaling** — scale machines up/down, auto-stop
- **Region selection** — deploy to specific global regions
- **Health checks** — monitor machine health
- **Network config** — IP allocation, private networking
- **Deployment** — rolling deploys with canary support

## Requirements

| Variable | Required | Description |
|----------|----------|-------------|
| `FLY_API_TOKEN` | ✅ | API key/token for Fly.io |

## Quick Start

```bash
# List apps
python3 {baseDir}/scripts/flyio.py apps --limit 20
```

```bash
# Get app details
python3 {baseDir}/scripts/flyio.py app-get my-app
```

```bash
# Create an app
python3 {baseDir}/scripts/flyio.py app-create '{"app_name":"my-service","org_slug":"personal"}'
```

```bash
# List machines
python3 {baseDir}/scripts/flyio.py machines --app my-app
```



## Commands

### `apps`
List apps.
```bash
python3 {baseDir}/scripts/flyio.py apps --limit 20
```

### `app-get`
Get app details.
```bash
python3 {baseDir}/scripts/flyio.py app-get my-app
```

### `app-create`
Create an app.
```bash
python3 {baseDir}/scripts/flyio.py app-create '{"app_name":"my-service","org_slug":"personal"}'
```

### `machines`
List machines.
```bash
python3 {baseDir}/scripts/flyio.py machines --app my-app
```

### `machine-get`
Get machine details.
```bash
python3 {baseDir}/scripts/flyio.py machine-get --app my-app mach_abc123
```

### `machine-start`
Start a machine.
```bash
python3 {baseDir}/scripts/flyio.py machine-start --app my-app mach_abc123
```

### `machine-stop`
Stop a machine.
```bash
python3 {baseDir}/scripts/flyio.py machine-stop --app my-app mach_abc123
```

### `machine-create`
Create a machine.
```bash
python3 {baseDir}/scripts/flyio.py machine-create --app my-app '{"config":{"image":"nginx:latest","guest":{"cpus":1,"memory_mb":256}}}'
```

### `volumes`
List volumes.
```bash
python3 {baseDir}/scripts/flyio.py volumes --app my-app
```

### `volume-create`
Create a volume.
```bash
python3 {baseDir}/scripts/flyio.py volume-create --app my-app '{"name":"data","size_gb":10,"region":"ord"}'
```

### `secrets`
List secrets.
```bash
python3 {baseDir}/scripts/flyio.py secrets --app my-app
```

### `secret-set`
Set a secret.
```bash
python3 {baseDir}/scripts/flyio.py secret-set --app my-app "DATABASE_URL" "postgres://..."
```

### `certs`
List certificates.
```bash
python3 {baseDir}/scripts/flyio.py certs --app my-app
```

### `regions`
List available regions.
```bash
python3 {baseDir}/scripts/flyio.py regions
```

### `status`
App status overview.
```bash
python3 {baseDir}/scripts/flyio.py status --app my-app
```


## Output Format

All commands output JSON by default. Add `--human` for readable formatted output.

```bash
# JSON (default, for programmatic use)
python3 {baseDir}/scripts/flyio.py apps --limit 5

# Human-readable
python3 {baseDir}/scripts/flyio.py apps --limit 5 --human
```

## Script Reference

| Script | Description |
|--------|-------------|
| `{baseDir}/scripts/flyio.py` | Main CLI — all Fly.io operations |

## Data Policy

This skill **never stores data locally**. All requests go directly to the Fly.io API and results are returned to stdout. Your data stays on Fly.io servers.

## Credits
---
Built by [M. Abidi](https://www.linkedin.com/in/mohammad-ali-abidi) | [agxntsix.ai](https://www.agxntsix.ai)
[YouTube](https://youtube.com/@aiwithabidi) | [GitHub](https://github.com/aiwithabidi)
Part of the **AgxntSix Skill Suite** for OpenClaw agents.

📅 **Need help setting up OpenClaw for your business?** [Book a free consultation](https://cal.com/agxntsix/abidi-openclaw)