|Docs

railway deployment

List and manage deployments for your services.

Usage

railway deployment <COMMAND> [OPTIONS]

Aliases

  • railway deployments

Subcommands

SubcommandAliasesDescription
listlsList deployments with IDs, statuses, and timestamps
updeployUpload and deploy (same as railway up)
redeployRedeploy latest deployment (same as railway redeploy)

Examples

List deployments

railway deployment list

Output:

Recent Deployments
  7422c95b-c604-46bc-9de4-b7a43e1fd53d | SUCCESS | 2024-01-15 10:30:00 PST
  a1b2c3d4-e5f6-7890-abcd-ef1234567890 | FAILED | 2024-01-15 09:15:00 PST
  ...

List more deployments

railway deployment list --limit 50

List deployments for specific service

railway deployment list --service backend

List deployments in JSON format

railway deployment list --json

Useful for scripting:

# Get the latest deployment ID
railway deployment list --json --limit 1 | jq -r '.[0].id'

Use deployment ID with logs

# Get deployment ID from list
railway deployment list

# View logs for specific deployment
railway logs 7422c95b-c604-46bc-9de4-b7a43e1fd53d

Options for

FlagDescription
-s, --service <SERVICE>Service to list deployments for (defaults to linked service)
-e, --environment <ENV>Environment to list deployments from (defaults to linked environment)
--limit <N>Maximum number of deployments to show (default: 20, max: 1000)
--jsonOutput in JSON format

Deployment statuses

StatusDescription
SUCCESSDeployment completed successfully
FAILEDDeployment failed
CRASHEDDeployment crashed after starting
BUILDINGDeployment is being built
DEPLOYINGDeployment is being deployed
INITIALIZINGDeployment is initializing
WAITINGDeployment is waiting
QUEUEDDeployment is queued
REMOVEDDeployment was removed
REMOVINGDeployment is being removed