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 --a...