Deploy to Fly.io

Deploy your agent app to the cloud in one command with Fly.io.

Prerequisites

Step-by-step

1

Install flyctl

# macOS
brew install flyctl

# Linux
curl -L https://fly.io/install.sh | sh

# Windows
powershell -Command "irm https://fly.io/install.ps1 | iex"
2

Authenticate

fly auth login

This opens your browser to log in. If you dont have an account, sign up at fly.io.

3

Create your project with Fly.io target

npx agentvoy create my-project --build-mode app --deploy-target fly-io --yes

This generates a deploy/fly.toml alongside your agent code.

4

Configure your .env

cd my-project-app
cp .env.example .env
# Add your API key to .env
5

Deploy

agentvoy deploy --target fly-io

AgentVoy automatically:

  • Checks flyctl auth status
  • Sets secrets from your .env file
  • Deploys to Fly.io
6

Access your live app

# Your agent is live at:
https://my-project.fly.dev

# DevTools dashboard:
https://my-project.fly.dev/dev

# Check status:
fly status

Generated files

+ Dockerfile
+ .dockerignore
+ deploy/fly.toml

Useful commands

$ fly logs # Stream live logs
$ fly status # Check deployment status
$ fly secrets set OPENAI_API_KEY=sk-... # Set secrets
$ fly scale count 2 # Scale to 2 instances
$ fly apps destroy my-project # Delete the app