> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voicegateway.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy to Fly.io

> Run the VoiceGateway fleet collector on Fly.io with managed Postgres, automatic HTTPS, and multi-region placement.

# Deploy to Fly.io

Low ops; automatic HTTPS; deploy in multiple regions to sit near your agents.

<Tip>
  Deploy in a region close to where your agents run to cut ingest latency. Fly lets you place machines in specific regions with `--region` on `fly deploy` or via the `primary_region` key in `fly.toml`.
</Tip>

## Prerequisites

* [`flyctl`](https://fly.io/docs/hands-on/install-flyctl/) installed
* A Fly account: `fly auth login`

## Configure

Create `fly.toml` in a working directory:

```toml theme={null}
app = "<your-app-name>"

[build]
  image = "mahimairaja/voicegateway:0.9.2"

[http_service]
  internal_port = 8080
  force_https = true
  auto_stop_machines = false
  min_machines_running = 1
```

## Add Postgres

**Option A: Fly Postgres (unmanaged)**

```bash theme={null}
fly postgres create --name <pg-app-name>
fly postgres attach <pg-app-name> --app <your-app-name>
```

`fly postgres attach` sets `DATABASE_URL` on your app automatically (in `postgres://...` form).

**Option B: Neon or another managed provider**

Skip `fly postgres create` and supply the connection string directly in the next step.

## Set secrets

<Warning>
  Fly's `DATABASE_URL` (from `fly postgres attach`) uses the `postgres://` scheme. VoiceGateway requires `postgresql+asyncpg://`. Copy the connection string and rewrite the scheme; everything after `://` stays the same.
</Warning>

```bash theme={null}
fly secrets set \
  VOICEGW_DB_URL="postgresql+asyncpg://<user>:<pass>@<host>:<port>/<db>" \
  VOICEGW_API_KEY="<your-ingest-key>"
```

`VOICEGW_API_KEY` must not start with `vk_`. Generate it with `openssl rand -hex 32`. No volume is needed since data is stored in Postgres.

## Deploy

```bash theme={null}
fly deploy
```

HTTPS is automatic at `https://<your-app-name>.fly.dev`.

## Verify

Follow the steps at [Verify](/deployment#verify), using `https://<your-app-name>.fly.dev` as the collector URL and `VOICEGW_API_KEY` as the key.

## Connect your agent

See [Connect your agent](/deployment#connect-your-agent). Use `https://<your-app-name>.fly.dev` as `collector_url` and `VOICEGW_API_KEY` as `api_key`.