railway-service

name	railway-service
description	Check service status, rename services, change service icons, link services, or create services with Docker images. For creating services with local code, prefer railway-new skill. For GitHub repo sources, use railway-new skill to create empty service then railway-environment skill to configure source.
version	1.0.0
author	Railway
license	MIT
tags	["Railway","Service","Status","Docker","Container","Infrastructure","Management"]
dependencies	["railway-cli"]
allowed-tools	Bash(railway:*)

Railway Service Management

Check status, update properties, and advanced service creation.

When to Use

• User asks about service status, health, or deployments
• User asks "is my service deployed?"
• User wants to rename a service or change service icon
• User wants to link a different service
• User wants to deploy a Docker image as a new service (advanced)

Note: For creating services with local code (the common case), prefer the railway-new skill which handles project setup, scaffolding, and service creation together.

For GitHub repo sources: Use railway-new skill to create empty service, then railway-environment skill to configure source.repo via staged changes API.

Create Service

Create a new service via GraphQL API. There is no CLI command for this.

Get Context

railway status --json

Extract:

• project.id - for creating the service
• environment.id - for staging the instance config

Create Service Mutation

mutation serviceCreate($input: ServiceCreateInput!) {
  serviceCreate(input: $input) {
    id
    name
  }
}

ServiceCreateInput Fields

Field	Type	Description
projectId	String!	Project ID (required)
name	String	Service name (auto-generated if omitted)
source.image	String	Docker image (e.g., nginx:latest)
source.repo	String	GitHub repo (e.g., )