Railway Deploy

Deploy agents to Railway with x402 payment configuration.

Prerequisites

# GitHub CLI
brew install gh  # macOS
# or: sudo apt install gh  # Ubuntu
gh auth login

# Railway CLI
npm install -g @railway/cli
railway login
# or set RAILWAY_TOKEN env var

Required Environment Variables

export RAILWAY_TOKEN="<your-railway-token>"
export PAYMENTS_RECEIVABLE_ADDRESS="<your-wallet-address>"

Step 1: Create GitHub Repository

cd <agent-name>

# Initialize and commit
git init
git add .
git commit -m "Initial commit: <agent-name>"

# Create public repo and push
gh repo create <username>/<agent-name> --public --source=. --push

Step 2: Link to Railway Project

# Option A: Create new project
railway init

# Option B: Link to existing project
railway link --project <project-id>

# Option C: Use project token (non-interactive)
echo '{"project":"<project-id>"}' > railway.json

Step 3: Create Service

# Add new service with env vars
railway add -s <agent-name> \
  -v "PAYMENTS_RECEIVABLE_ADDRESS=<wallet>" \
  -v "FACILITATOR_URL=https://facilitator.daydreams.systems" \
  -v "NETWORK=base"

If service already exists:

railway variables set \
  PAYMENTS_RECEIVABLE_ADDRESS=<wallet> \
  FACILITATOR_URL=https://facilitator.daydreams.systems \
  NETWORK=base \
  --service <agent-name>

Step 4: Deploy

# Deploy and detach
railway up --detach --service <agent-name>

Step 5: Configure Domain

# Generate Railway domain
railway domain --service <agent-name>

# Output: https://<agent-name>-production.up.railway.app

Step 6: Verify Deployment

# Wait for build (60-90 seconds)
sleep 90

# Check service status
railway service status --service <agent-name>

# Test health endpoint
curl -s https://<agent-name>-production.up.railway.app/health

# Test free endpoint
curl -s -X POST https://<agent-name>-production.up.railway.app/entrypoints/overview/invoke \
  -H "Content-Type: application/json" -d '{}'

Environment Variables Reference

Variable	Value	Purpose
PAYMENTS_RECEIVABLE_ADDRESS	0x...	Your wallet for x402 payments
FACILITATOR_URL	https://facilitator.daydreams.systems	Payment processing
NETWORK	base	Blockchain network
PORT	(auto)	Railway sets this automatically

Troubleshooting

Build Fails

# Check build logs
railway logs --build --service <agent-name>

Service Not Found

# List services
railway service status

# Check project
railway status

Unauthorized

# Re-authenticate
railway logout
railway login

# Or use project token
export RAILWAY_TOKEN="<project-token>"

Domain Not Working

# Re-create domain
railway domain --service <agent-name>

# Check deployment status
railway service status --service <agent-name>

Output

Provide:

1. GitHub URL: https://github.com/<user>/<agent-name>
2. Railway URL: https://<agent-name>-production.up.railway.app
3. Deployment status: SUCCESS/FAILED
4. Health check result: OK/ERROR

Next Step

→ Update portfolio and announce the new agent