
Deploy Gas Town
Multi-agent coding workspace: a Mayor coordinating Claude Code agents
Gas Town
Just deployed
Deploy and Host Gas Town on Railway
Gas Town is a multi-agent workspace for coding agents. A Mayor agent breaks work into beads (issues) and convoys, and dispatches worker agents (polecats, crew, witnesses, a refinery) that run Claude Code in tmux sessions against your git repositories, with state tracked in a Dolt database.
About Hosting Gas Town
This template builds the official Gas Town image (Dockerfile, based on Docker's Claude Code sandbox image with Go, Dolt, beads and tmux) and runs it as an always-on workspace:
- The Gas Town HQ at /gt and the agent home folder (Claude Code login, git and gh credentials) on a persistent volume
- The
gt dashboardweb UI on your public domain, behind HTTP Basic auth with a generated password gt installruns on every start, like the upstream Docker setup, and the beads database is migrated to the installedbdversion- Agents run as the unprivileged
agentuser
The first build takes several minutes.
After deploy:
- Open https://YOUR-RAILWAY-DOMAIN and sign in as GASTOWN_DASHBOARD_USER with GASTOWN_DASHBOARD_PASSWORD from the service Variables tab.
- Open a shell in the container with the Railway CLI:
railway ssh, thencd /gt. - Sign in to Claude Code once: run
claudeand follow the login. The session is stored on the volume. - Optional:
gh auth loginfor private GitHub repositories. - Add a project and start the town:
gt rig add myproject https://github.com/you/repo.git,gt enable,gt up --restore, thengt mayor attachto talk to the Mayor. - Watch agents, convoys and merge queues in the dashboard.
Common Use Cases
- Run a fleet of Claude Code agents on a repository around the clock
- Break a large change into tracked beads and convoys handled in parallel
- Keep long agent sessions running away from your laptop
- Monitor agents, queues and escalations from a browser
Dependencies for Gas Town Hosting
- Source: https://github.com/gastownhall/gastown (MIT license)
- A Claude subscription or account for Claude Code (sign in from the container)
- Git repositories the agents can clone
Deployment Dependencies
- https://github.com/gastownhall/gastown
- https://github.com/gastownhall/gastown/blob/main/docs/docker.md
Implementation Details
- Upstream treats the dashboard as a trusted local surface (it can run gt commands). Here it listens on loopback only, and a small Node proxy (GASTOWN_AUTH_PROXY) in front of it requires the password on every request; /healthz is the only open path.
- Railway allows one volume per service, so GASTOWN_BOOT keeps both /gt and /home/agent under /data with symlinks. The home folder is copied from the image on first boot, the same as the upstream agent-home volume.
- The image installs the latest
bdrelease, whose schema is newer than the databasegt installcreates, so the start script runsbd migrate schemabefore starting the dashboard. - Agents can run many processes; give the service enough memory for the number of workers you start.
Why Deploy Gas Town on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying Gas Town on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
Gas Town
gastownhall/gastown
