railway-service-management

name

railway-service-management

description

Specialized knowledge for managing multi-environment Railway deployments. Use when: (1) Setting up Railway projects/environments/services, (2) Configuring deployments and builds (NIXPACKS/Railpack/Dockerfile), (3) Managing Railway CLI operations and logs, (4) Implementing PR environments or branch-based workflows, (5) Troubleshooting deployment failures or health checks, (6) Managing secrets/variables across environments, (7) Optimizing Railway costs and resources, (8) Configuring databases/volumes/networking, (9) Setting up CI/CD with GitHub Actions, (10) Cloud Agent sessions needing Railway CLI access with RAILWAY_API_TOKEN-based authentication.

Contents

• Quick Start for Cloud Agents
• Quick Start
• Essential Workflows
• Reference Documentation
• Critical Guidelines

Quick Start for Cloud Agents

Railway CLI is automatically configured for Cloud Agents (GitHub Copilot Workspace).

• Installs Railway CLI via npm
• Authenticates using RAILWAY_API_TOKEN
• Auto-detects and links to the correct environment (PR or production)
• Links to project: yoto, service: yoto-smart-stream

You can immediately use Railway CLI commands:

railway status --json
railway logs --lines 50 --filter "@level:error" --json
railway var list --json
railway deployment list --json

For detailed instructions: See Cloud Agent Authentication

Quick Start

Monitoring Deployment Status Loop

 sleep 5 &&  ;  STATUS=$(railway deployment list --json | jq -r );  ;  [  =  ];   ; ;  [  =  ];   ;  1; ;  5;