mcpField
R
railway

railway

github.com/hoodiniCloud & DevOps291135 installsUpdated 2d ago
Repository

About railway

A skill for deploying and managing applications on Railway. It covers CLI setup, service configuration, databases, storage, networking, and scheduled jobs.

Key features

  1. 01Configure builds and deployments
  2. 02Set environment variables
  3. 03Add PostgreSQL, Redis, and MySQL
  4. 04Manage private networking and volumes
  5. 05Configure cron jobs and health checks

Use cases

  1. 01Deploy an application with Railway CLI
  2. 02Configure a multi-service project
  3. 03Attach persistent storage to a service

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hoodini/ai-agents-skills --skill railway

After installing, type/railwayin Claude Code to confirm it loaded.

Details

From the project README

Railway Deployment

Deploy and manage applications on Railway's platform.

Quick Start

# Install Railway CLI
npm i -g @railway/cli

# Login
railway login

# Initialize project
railway init

# Deploy
railway up

railway.toml Configuration

[build]
builder = "nixpacks"
buildCommand = "npm run build"

[deploy]
startCommand = "npm start"
healthcheckPath = "/health"
healthcheckTimeout = 300
restartPolicyType = "on_failure"
restartPolicyMaxRetries = 3

[service]
internalPort = 3000

Nixpacks Configuration

# nixpacks.toml
[phases.setup]
nixPkgs = ["nodejs-18_x", "python311"]

[phases.install]
cmds = ["npm ci"]

[phases.build]
cmds = ["npm run build"]

[start]
cmd = "npm start"

Environment Variables

# Set variable
railway variables set DATABASE_URL="postgres://..."

# Set from file
railway variables set < .env

# Link to service
railway service
railway variables set API_KEY="secret"

Database Services

PostgreSQL
# Add PostgreSQL
railway add -d postgres

# Get connection string
railway variables get DATABASE_URL
Redis
railway add -d redis
# Access via REDIS_URL
MySQL
railway add -d mysql
# Access via MYSQL_URL

Private Networking

# Services can communicate via internal DNS
# Format: ${{service-name}}.railway.internal

# Example: API calling database service
DATABASE_HOST: ${{postgres.railway.internal}}
DATABASE_PORT: 5432

Volumes (Persistent Storage)

# Create volume
railway volume create my-data

# Mount in service
railway volume attach my-data:/app/data

In code:

// Data persists across deploys
const dataPath = '/app/data';
fs.writeFileSync(`${dataPath}/file.json`, JSON.stringify(data));

Cron Jobs

# railway.toml
[deploy]
startCommand = "node cron.js"
cronSchedule = "0 */6 * * *"  # Every 6 hours

Multi-Service Setup

my-project/
├── api/
│   ├── railway.toml
│   └── ...
├── worker/
│   ├── railway.toml
│   └── ...
└── frontend/
    ├── railway.toml
    └── ...

Deploy each:

cd api && railway up
cd ../worker && railway up
cd ../frontend && railway up

Dockerfile Deploy

FROM node:18-alpine

WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .

EXPOSE 3000
CMD ["npm", "start"]

# railway.toml
[build]
builder = "dockerfile"
dockerfilePath = "./Dockerfile"

Health Checks

// Express health endpoint
app.get('/health', (req, res) => {
  res.status(200).json({ 
    status: 'healthy',
    timestamp: new Date().toISOString()
  });
});

# railway.toml
[deploy]
healthcheckPath = "/health"
healthcheckTimeout = 100

Resources

Comments

Markdown supported