railway-deploy

Automates Railway project creation, GitHub repo linking, and service deployment via GraphQL API.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill railway-deploy-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: railway-deploy
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/railway-deploy
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill railway-deploy-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deploying applications to Railway manually involves repetitive steps across the Railway dashboard and GitHub. This Skill automates the full deployment pipeline programmatically, from creating a GitHub repository to linking it to a Railway service with auto-deploy on push. ## Core Features & Use Cases - Full Deployment Pipeline: Create a GitHub repo with gh, push code, create a Railway project and service via GraphQL mutations, then connect the repo for automatic deployments. - Project & Service Management: Query project status, services, and domains, set environment variables with variableUpsert, and delete projects when no longer needed. - Use Case: You have a full-stack app with a frontend and backend repo. Use this Skill to create one Railway project, spin up web and api services, link each to its GitHub repo, set shared environment variables, and let Railway auto-deploy both on every push. ## Quick Start Deploy my app to Railway by creating a new project, linking it to my GitHub repository, and enabling auto-deploy on push.

Frequently Asked Questions about railway-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a GitHub repo to Railway programmatically?

Create a Railway project with the projectCreate GraphQL mutation, add a service with serviceCreate, then link your repo using serviceConnect with the repo name and branch. Railway auto-deploys on every push to the connected branch.

How to create a Railway project using the GraphQL API?

Send a POST request to https://backboard.railway.com/graphql/v2 with a Bearer token and the projectCreate mutation including your project name. The response returns the project ID and environment IDs needed for subsequent service operations.

What authentication does the Railway API require?

The Railway GraphQL API requires a Bearer token sent in the Authorization header. The token is stored locally per agent as an environment variable and is not shared across machines or via MCP.

Can I deploy a monorepo to Railway with multiple services?

Yes, create one Railway project and a separate service per sub-package, all linked to the same repository. Use serviceUpdate to set a different root directory and build path for each service.

How do I set environment variables for a Railway service?

Use the variableUpsert GraphQL mutation with the project ID, environment ID, service ID, and the variable name and value. Railway also auto-detects common frameworks like Next.js, Express, and FastAPI for build and start commands.

What are the limitations of deploying on Railway's free tier?

The free tier has usage limits that may not suit production workloads, so check Railway pricing before scaling. Additionally, the Railway token and GitHub CLI authentication are per-agent and must be configured on each machine.