railway-deployment

name	railway-deployment
description	Manage Railway deployments - view logs, redeploy, restart, or remove deployments. Use for deployment lifecycle (remove, stop, redeploy, restart), deployment visibility (list, status, history), and troubleshooting (logs, errors, failures, crashes). NOT for deleting services - use railway-environment skill with isDeleted for that.
version	1.0.0
author	Railway
license	MIT
tags	["Railway","Deployment","Logs","Debug","Troubleshooting","Redeploy","Infrastructure"]
dependencies	["railway-cli"]
allowed-tools	Bash(railway:*)

Railway Deployment Management

Manage existing Railway deployments: list, view logs, redeploy, or remove.

Important: "Remove deployment" (railway down) stops the current deployment but keeps the service. To delete a service entirely, use the railway-environment skill with isDeleted: true.

When to Use

• User says "remove deploy", "take down service", "stop deployment", "railway down"
• User wants to "redeploy", "restart the service", "restart deployment"
• User asks to "list deployments", "show deployment history", "deployment status"
• User asks to "see logs", "show logs", "check errors", "debug issues"

List Deployments

railway deployment list --limit 10 --json

Shows deployment IDs, statuses, and metadata. Use to find specific deployment IDs for logs or debugging.

Specify Service

railway deployment list --service backend --limit 10 --json

View Logs

Deploy Logs

railway logs --lines 100 --json

In non-interactive mode, streaming is auto-disabled and CLI fetches logs then exits.

Build Logs

railway logs --build --lines 100 --json

For debugging build failures or viewing build output.

Logs for Failed/In-Progress Deployments

By default railway logs shows the last successful deployment. Use --latest for current:

railway logs --latest --lines 100 --json

Filter Logs

# Errors only
railway logs --lines 50 --filter "@level:error" --json

# Text search
railway logs --lines 50 --filter "connection refused" --json

# Combined
railway logs --lines 50 --filter "@level:error AND timeout" --json

Time-Based Filtering

# Logs from last hour
railway logs --since 1h --lines 100 --json

# Logs between 30 and 10 minutes ago
railway logs --since 30m -- 10m --lines 100 --json


railway logs --since 2024-01-15T10:00:00Z --lines 100 --json