railway-templates

Railway Templates

Search and deploy services from Railway's template marketplace.

When to Use

• User asks to "add Postgres", "add Redis", "add a database"
• User asks to "add Ghost", "add Strapi", "add n8n", or any other service
• User wants to find templates for a use case (e.g., "CMS", "storage", "monitoring")
• User asks "what templates are available?"
• User wants to deploy a pre-configured service

Common Template Codes

Category	Template	Code
Databases	PostgreSQL	postgres
	Redis	redis
	MySQL	mysql
	MongoDB	mongodb
CMS	Ghost	ghost
	Strapi	strapi
Storage	Minio	minio
Automation	n8n	n8n
Monitoring	Uptime Kuma	uptime-kuma

For other templates, use the search query below.

Prerequisites

Get project context:

railway status --json

Extract:

• id - project ID
• environments.edges[0].node.id - environment ID

Get workspace ID:

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query getWorkspace($projectId: String!) {
    project(id: $projectId) { workspaceId }
  }' \
  '{"projectId": "PROJECT_ID"}'
SCRIPT

Search Templates

List available templates with optional filters:

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query templates($first: Int, $verified: Boolean) {
    templates(first: $first, verified: $verified) {
      edges {
        node {
          name
          code
          description
          category
        }
      }
    }
  }' \
  '{"first": 20, "verified": true}'
SCRIPT

Arguments

Argument	Type	Description
first	Int	Number of results (max ~100)
verified	Boolean	Only verified templates
recommended	Boolean	Only recommended templates

Rate Limit

10 requests per minute. Don't spam searches.

Get Template Details

Fetch a specific template by code:

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query template($code: String!) {
    template(code: $code) {
      id
      name
      description
      serializedConfig
    }
  }' \
  '{"code": "postgres"}'
SCRIPT

Returns:

• id - template ID (needed for deployment)
• serializedConfig - service configuration (needed for deployment)

Deploy Template

Step 1: Fetch Template

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query template($code: String!) {
    template(code: $code) {
      id
      serializedConfig
    }
  }' \
  '{"code": "postgres"}'
SCRIPT

Step 2: Deploy to Project

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation deployTemplate($input: TemplateDeployV2Input!) {
    templateDeployV2(input: $input) {
      projectId
      workflowId
    }
  }' \
  '{
    "input": {
      "templateId": "TEMPLATE_ID_FROM_STEP_1",
      "serializedConfig": SERIALIZED_CONFIG_FROM_STEP_1,
      "projectId": "PROJECT_ID",
      "environmentId": "ENVIRONMENT_ID",
      "workspaceId": "WORKSPACE_ID"
    }
  }'
SCRIPT

Important: serializedConfig is the exact JSON object from the template query, not a string.

Composability

• Connect services: Use railway-environment skill to add variable references
• View deployed service: Use railway-service skill
• Check logs: Use railway-deployment skill
• Add domains: Use railway-domain skill