---
title: "Deploy core-gateway"
description: "Deploy and host core-gateway "
category: "Automation"
url: https://railway.com/deploy/core-gateway
---

# Deploy core-gateway

Deploy and host core-gateway 

**[Deploy core-gateway on Railway](https://railway.com/template/core-gateway)**

- **Creator:** Harshith Mullapudi's Projects
- **Category:** Automation
- **Total deploys:** 5

## Template content

### core-gateway

- **Image:** redplanethq/core-gateway:0.6.14

## Documentation

# Deploy and Host CoreBrain Gateway on Railway                                                                                                                                        
                                                                                                                                                                                        
  The CoreBrain Gateway is a single-container runtime that gives your CORE workspace a remote machine to *do work* on — clone repos, run shell commands, drive a browser, and run coding
   agents (Claude Code + Codex) — all from the CORE webapp. One container, one Railway volume, one URL. No local install needed.
                                                                                                                                                                                        
  ## About Hosting CoreBrain Gateway                                                                                                                                                    
   
  Deploying a gateway means standing up a long-lived container that connects back to your CORE webapp and registers itself as an executor. The webapp dispatches tasks (file ops, shell 
  commands, browser automation, agent runs) over HTTPS to your gateway; the gateway runs them and streams results back. The image ships with Claude Code, Codex CLI, Playwright, and
  Brave pre-installed, so the only setup is wiring credentials.                                                                                                                         
                  
  The gateway image has a built-in Railway mode (`COREBRAIN_DEPLOY_MODE=railway`) that maps both the workspace (`/app`) and gateway state (`/home/corebrain`) into a single mounted     
  volume — one volume covers cloned repos, agent login state, and Playwright/Brave cache.
                                                                                                                                                                                        
  ## Common Use Cases                                                                                                                                                                   
   
  - Remote coding agent runtime (Claude Code + Codex over the web)                                                                                                                      
  - Cloud workspace for cloning, editing, and pushing private repos
  - Headless browser automation via Brave + Playwright
  - Always-on executor for CORE tasks without leaving a laptop running                                                                                                                  
  - Shared team gateway pinned to a known security key
                                                                                                                                                                                        
  ## Dependencies for CoreBrain Gateway Hosting                                                                                                                                         
   
  - A CORE webapp instance (`COREBRAIN_API_URL`)                                                                                                                                        
  - A personal access token for that workspace (`COREBRAIN_API_KEY`)
  - A Railway volume mounted at `/mnt/volume` for persistent state
                                                                                                                                                                                        
  ### Optional Dependencies
                                                                                                                                                                                        
  - `GITHUB_TOKEN` — enables `git clone` / `git push` on private repos and auto-fills the gateway's git author identity                                                                 
  - `CLAUDE_CODE_OAUTH_TOKEN` — pre-authenticates Claude Code (skip the OAuth flow)
  - `OPENAI_API_KEY` — pre-authenticates Codex CLI                                                                                                                                      
  - `COREBRAIN_GATEWAY_SECURITY_KEY` — pin to a known value; omit on first boot to let the gateway generate one and print it to the deploy logs
                                                                                                                                                                                        
  ### Deployment Dependencies
                                                                                                                                                                                        
  - [CoreBrain Gateway Docker image](https://hub.docker.com/r/redplanethq/core-gateway)                                                                                                 
   
  ## Why Deploy CoreBrain Gateway on Railway?                                                                                                                                           
                  
  Railway is a singular platform to deploy your infrastructure stack. Railway will host your gateway so you don't have to deal with VM provisioning, TLS, or volume management, while   
  letting you scale CPU/RAM as your agent workloads grow.
                                                                                                                                                                                        
  By deploying the CoreBrain Gateway on Railway you get a public HTTPS URL, persistent storage for cloned repos and agent login state, and one-click rolling updates when a new image   
  ships — all paired with the rest of your CORE stack (webapp, database, MCP servers) on the same project. Drop in the env vars, mount one volume, copy the security key from the boot
  logs into the CORE webapp's *Register Gateway* dialog, and you're connected.

## Similar templates

- [N8N Main + Worker](https://railway.com/deploy/n8n-main-worker) — Deploy and Host N8N with Inactive worker.
- [Evolution API with n8n](https://railway.com/deploy/evolution-api-with-n8n) — Build a WhatsApp automation platform with Evolution API, n8n & Postgres.
- [Postgres Backup](https://railway.com/deploy/postgres-s3-backups) — Cron-based PostgreSQL backup to bucket storage

Open this page in a browser: https://railway.com/deploy/core-gateway