About deploy-railway
A skill for deploying applications to Railway using its CLI and configuration files. It covers project setup, build and deployment options, environment variables, databases, domains, logs, and preview environments.
Key features
- 01Railway CLI setup and deployment
- 02Build configuration with railway.json
- 03Environment variable management
- 04PostgreSQL provisioning
- 05Domain and log commands
- 06Preview environment guidance
Use cases
- 01Deploying an application to Railway
- 02Setting production environment variables
- 03Adding a PostgreSQL database
- 04Reviewing deployment logs
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ dralgorhythm/ claude-agentic-framework --skill deploy-railwayAfter installing, type/deploy-railwayin Claude Code to confirm it loaded.
Details
From the project READMEDeploy to Railway
Why Railway?
- Zero config deployments
- Automatic HTTPS
- Built-in databases
- Environment management
- Preview environments
Quick Start
# Install CLI
npm install -g @railway/cli
# Login
railway login
# Initialize project
railway init
# Deploy
railway up
Configuration
railway.json
{
"build": {
"builder": "NIXPACKS"
},
"deploy": {
"startCommand": "npm start",
"healthcheckPath": "/health",
"restartPolicyType": "ON_FAILURE"
}
}
Environment Variables
# Set variable
railway variables set DATABASE_URL=postgres://...
# Set from file
railway variables set < .env.production
Database Setup
# Add PostgreSQL
railway add --database postgres
# Get connection URL
railway variables get DATABASE_URL
Deployment Workflow
1. Connect Repo
railway link
2. Configure Build
Railway auto-detects most frameworks. Override with:
# Nixpacks (default)
railway up
# Dockerfile
railway up --dockerfile
3. Set Domain
railway domain
Best Practices
- Use Preview Environments: Test PRs before merge
- Separate Databases: Different DB per environment
- Use Variables: Never hardcode secrets
- Health Checks: Enable for reliability
- Logs: Use
railway logsfor debugging
Common Commands
# View logs
railway logs
# Open dashboard
railway open
# Run command in environment
railway run npm run migrate
# List services
railway status
Comments
Markdown supported