Railway CI/CD integration and automation. Use when setting up GitHub Actions, GitLab CI, automated deployments, migration scripts, or programmatic Railway workflows.
64
77%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/railway-automation/SKILL.mdAutomate Railway deployments with CI/CD pipelines, migration scripts, and event-driven workflows.
GitHub Actions (5 minutes)
# .github/workflows/railway.yml
- uses: railway/deploy@v1
with:
railway_token: ${{ secrets.RAILWAY_TOKEN }}
service: apiGitLab CI (5 minutes)
# .gitlab-ci.yml
deploy:
script:
- railway up --service api
only: [main]Migration (10 minutes)
./scripts/migrate.sh --from heroku --project myappSetup Process
railway login && railway token)RAILWAY_TOKEN).github/workflows/railway.yml)Use Cases
Template: See templates/github-workflow.yml
Reference: references/github-actions.md for complete guide with 5+ workflow examples
Setup Process
RAILWAY_TOKEN).gitlab-ci.ymlUse Cases
Template: See templates/gitlab-ci.yml
Reference: references/gitlab-ci.md for complete guide with pipeline examples
Generic Pattern (Any Platform)
# Install Railway CLI
npm i -g @railway/cli
# Login with token
export RAILWAY_TOKEN=$YOUR_TOKEN
# Link project
railway link $PROJECT_ID
# Deploy
railway up --service $SERVICE_NAME --environment $ENVIRONMENTEnvironment Variables
RAILWAY_TOKEN: Authentication tokenRAILWAY_PROJECT_ID: Project identifier (optional if linked)RAILWAY_SERVICE: Service name (optional)RAILWAY_ENVIRONMENT: Environment name (optional)Health Check Pattern
# Deploy and wait for health
railway up --service api
sleep 30
# Verify deployment
DEPLOY_URL=$(railway status --json | jq -r '.url')
curl -f $DEPLOY_URL/health || exit 1Supported Platforms
Interactive Migration Script
# From Heroku
./scripts/migrate.sh --from heroku --project myapp
# From Vercel
./scripts/migrate.sh --from vercel --project myapp --env production
# Dry run (preview changes)
./scripts/migrate.sh --from render --project myapp --dry-runScript Features
Supported Migrations
Reference: references/migration-patterns.md for detailed guides per platform
Cron-Based Deployments
# GitHub Actions - Deploy every night at 2 AM
on:
schedule:
- cron: '0 2 * * *'
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: railway/deploy@v1
with:
railway_token: ${{ secrets.RAILWAY_TOKEN }}Database Backups
# Scheduled backup workflow
on:
schedule:
- cron: '0 0 * * *' # Daily at midnight
jobs:
backup:
steps:
- name: Backup database
run: |
railway run pg_dump > backup.sql
aws s3 cp backup.sql s3://backups/$(date +%Y%m%d).sqlHealth Check Monitoring
# Hourly health checks
on:
schedule:
- cron: '0 * * * *'
jobs:
health:
steps:
- name: Check service health
run: |
curl -f ${{ secrets.SERVICE_URL }}/health || \
curl -X POST ${{ secrets.SLACK_WEBHOOK }} \
-d '{"text":"Service down!"}'GitHub Webhook → Railway Deploy
// Webhook handler
app.post('/webhook/github', async (req, res) => {
const { ref, repository } = req.body;
if (ref === 'refs/heads/main') {
const { exec } = require('child_process');
exec('railway up --service api', (error, stdout) => {
console.log(stdout);
});
}
res.json({ status: 'ok' });
});Railway Webhook Events Railway supports webhooks for:
Configure Webhooks
# Via Railway CLI
railway webhooks add \
--url https://yourapp.com/webhook \
--events deployment.success,deployment.failure
# Via API
curl -X POST https://backboard.railway.app/graphql \
-H "Authorization: Bearer $TOKEN" \
-d '{
"query": "mutation { webhookCreate(input: {...}) }"
}'Notification Integration
# Slack notification on deploy
railway webhooks add \
--url $SLACK_WEBHOOK_URL \
--events deployment.success \
--transform '{
"text": "Deployed {{service}} to {{environment}}"
}'# Deploy to staging first, then production
jobs:
staging:
environment: staging
steps:
- uses: railway/deploy@v1
with:
railway_token: ${{ secrets.RAILWAY_TOKEN }}
environment: staging
production:
needs: staging
environment: production
steps:
- uses: railway/deploy@v1
with:
railway_token: ${{ secrets.RAILWAY_TOKEN }}
environment: production# Create preview for each PR
on:
pull_request:
types: [opened, synchronize]
jobs:
preview:
steps:
- uses: railway/deploy@v1
with:
railway_token: ${{ secrets.RAILWAY_TOKEN }}
service: api-pr-${{ github.event.pull_request.number }}# Automatic rollback if health check fails
jobs:
deploy:
steps:
- name: Deploy
id: deploy
run: railway up --service api
- name: Health check
run: curl -f $SERVICE_URL/health
- name: Rollback on failure
if: failure()
run: railway rollback --service api# Deploy multiple services in parallel
strategy:
matrix:
service: [api, worker, cron]
steps:
- uses: railway/deploy@v1
with:
railway_token: ${{ secrets.RAILWAY_TOKEN }}
service: ${{ matrix.service }}Generate Token
# CLI method
railway login
railway token
# Copy token to clipboard
railway token | pbcopy # macOS
railway token | xclip # LinuxAdd to CI Platform
GitHub
Settings → Secrets and variables → Actions → New repository secret
Name: RAILWAY_TOKEN
Value: [paste token]GitLab
Settings → CI/CD → Variables → Add variable
Key: RAILWAY_TOKEN
Value: [paste token]
Protected: Yes
Masked: YesCircleCI
Project Settings → Environment Variables → Add Variable
Name: RAILWAY_TOKEN
Value: [paste token]Token Rotation
# Generate new token
NEW_TOKEN=$(railway token)
# Update in CI (platform-specific)
# Then invalidate old token via dashboardDetect Environment in Code
const env = process.env.RAILWAY_ENVIRONMENT || 'development';
const config = {
development: { db: 'localhost:5432' },
staging: { db: process.env.DATABASE_URL },
production: { db: process.env.DATABASE_URL }
};
export default config[env];Conditional Deployment
# Only deploy staging on feature branches
jobs:
deploy-staging:
if: github.ref != 'refs/heads/main'
steps:
- uses: railway/deploy@v1
with:
environment: staging
deploy-production:
if: github.ref == 'refs/heads/main'
steps:
- uses: railway/deploy@v1
with:
environment: productionEnvironment Variable Management
# Export from staging
railway env --environment staging > .env.staging
# Import to production (selective)
cat .env.staging | grep -v SECRET | railway env --environment productionDeployment Fails in CI
# Check token validity
railway whoami
# Verify project link
railway status
# Check service exists
railway list
# View deployment logs
railway logs --service apiToken Authentication Errors
# Regenerate token
railway logout
railway login
railway token
# Update in CI secrets
# Test locally first
RAILWAY_TOKEN=$NEW_TOKEN railway statusEnvironment Not Found
# List available environments
railway environment list
# Verify environment name matches
railway status --environment productionService Not Deploying
# Check service name
railway list
# Verify service configuration
railway status --service api
# Check for build errors
railway logs --service api --deployment latest93ed392
Also appears in
since Sep 12, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.