Deploy to Railway

One-click cloud deployment with Railway. No Docker knowledge needed.

Prerequisites

  • 1. Railway account — railway.app (free trial with $5 credit)
  • 2. Railway CLI — npm install -g @railway/cli
  • 3. Logged in via railway login

Step-by-step

1

Install Railway CLI

npm install -g @railway/cli
2

Authenticate

railway login

Opens your browser to authenticate with Railway.

3

Create your project with Railway target

npx agentvoy create my-project --build-mode app --deploy-target railway --yes
4

Configure your .env

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

Deploy

agentvoy deploy --target railway

AgentVoy initializes a Railway project, sets environment variables from your .env, and deploys.

6

Access your app

# Get your deployment URL
railway open

# View logs
railway logs

Generated files

+ Dockerfile
+ .dockerignore
+ deploy/railway.json

Useful commands

$ railway logs # Stream logs
$ railway variables set OPENAI_API_KEY=sk-... # Set variables
$ railway open # Open dashboard
$ railway down # Tear down