Railway

Railway is a PaaS that deploys Docker containers with zero configuration.

One-Click Deploy

Or deploy manually from the CLI:

Manual Deploy

1. Install the Railway CLI

npm i -g @railway/cli
railway login

2. Create a Project

railway init

3. Add a Volume for Persistence

Railway containers are ephemeral. You need a volume so the SQLite database survives redeploys.

railway volume add --mount /data

4. Set Environment Variables

railway variables set WCP_DB_PATH=/data/sync.db
railway variables set WCP_CONFIG_PATH=/data/config.json
railway variables set WCP_CORS_ORIGINS=https://your-dashboard.example.com

5. Deploy

From the WCP repository root:

railway up

Railway detects the Dockerfile and builds automatically.

6. Get Your URL

railway domain

Your WCP instance is live at https://<project>.up.railway.app.

railway.toml

For reproducible deploys, add this to the repo root:

[build]
builder = "dockerfile"

[deploy]
healthcheckPath = "/health"
healthcheckTimeout = 30
restartPolicyType = "on_failure"
restartPolicyMaxRetries = 3

Dashboard Deployment

Deploy the React dashboard as a separate Railway service:

1. Set the build command to cd dashboard && npm ci && npm run build
2. Set the start command to npx serve dashboard/dist -l 3000
3. Set VITE_API_URL to your WCP API Railway URL