deployment

$2a

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 --until 10m --lines 100 --json

# Logs from specific timestamp

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

Formats: relative (30s, 5m, 2h, 1d, 1w) or ISO 8601 timestamps.

Logs from Specific Deployment

Deploy logs:

railway logs <deployment-id> --lines 100 --json

Build logs:

railway logs --build <deployment-id> --lines 100 --json

Get deployment ID from railway deployment list.

Note: The deployment ID is a positional argument, NOT --deployment <id>. The --deployment flag is a boolean that selects deploy logs (vs --build for build logs).

Redeploy

Redeploy the most recent deployment:

railway redeploy --service <name> -y

The -y flag skips confirmation. Useful when:

• Config changed via environment skill

• Need to restart without new code

• Previous deploy succeeded but service misbehaving

Restart Container Only

Restart without rebuilding (picks up external resource changes):

railway restart --service <name> -y

Use when external resources (S3 files, config maps) changed but code didn't.

Remove Deployment

Takes down the current deployment. The service remains but has no running deployment.

# Remove deployment for linked service

railway down -y

# Remove deployment for specific service

railway down --service web -y

railway down --service api -y

This is what users mean when they say "remove deploy", "take down", or "stop the deployment".

Note: This does NOT delete the service. To delete a service entirely, use the environment skill with isDeleted: true.

CLI Options

deployment list

Flag

Description

-s, --service <NAME>

Service name or ID

-e, --environment <NAME>

Environment name or ID

--limit <N>

Max deployments (default 20, max 1000)

--json

JSON output

logs

Flag

Description

-s, --service <NAME>

Service name or ID

-e, --environment <NAME>

Environment name or ID

-d, --deployment

Show deploy logs (default, boolean flag)

-b, --build

Show build logs (boolean flag)

-n, --lines <N>

Number of lines (required)

-f, --filter <QUERY>

Filter using query syntax

--since <TIME>

Start time (relative or ISO 8601)

--until <TIME>

End time (relative or ISO 8601)

--latest

Most recent deployment (even if failed)

--json

JSON output

[DEPLOYMENT_ID]

Specific deployment (optional)

redeploy

Flag

Description

-s, --service <NAME>

Service name or ID

-y, --yes

Skip confirmation

restart

Flag

Description

-s, --service <NAME>

Service name or ID

-y, --yes

Skip confirmation

down

Flag

Description

-s, --service <NAME>

Service name or ID

-e, --environment <NAME>

Environment name or ID

-y, --yes

Skip confirmation

Presenting Logs

When showing logs:

• Include timestamps

• Highlight errors and warnings

• For build failures: show error and suggest fixes

• For runtime crashes: show stack trace context

• Summarize patterns (e.g., "15 timeout errors in last 100 logs")

Composability

• Push new code: Use deploy skill

• Check service status: Use status skill

• Fix config issues: Use environment skill

• Create new service: Use new skill

Error Handling

No Service Linked

No service linked. Run `railway service` to select one.

No Deployments Found

No deployments found. Deploy first with `railway up`.

No Logs Found

Deployment may be too old (log retention limits) or service hasn't produced output.