---
title: "Deploy Gitterm"
description: "Run Opencode Anytime, Anywhere, on Any Cloud"
category: "Other"
url: https://railway.com/deploy/gitterm
---

# Deploy Gitterm

Run Opencode Anytime, Anywhere, on Any Cloud

**[Deploy Gitterm on Railway](https://railway.com/template/gitterm)**

- **Creator:** OpeOginni's Projects
- **Category:** Other
- **Total deploys:** 53

## Template content

### gitterm-server https://devicons.railway.app/Hono

- **Image:** ghcr.io/opeoginni/gitterm-server

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2.1
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:17

### gitterm-web https://svgl.app/library/nextjs_icon_dark.svg

- **Image:** ghcr.io/opeoginni/gitterm-web

### gitterm-listener https://devicons.railway.app/Hono

- **Image:** ghcr.io/opeoginni/gitterm-listener

### gitterm-idle-reaper-worker https://devicons.railway.app/Bun

- **Image:** ghcr.io/opeoginni/gitterm-idle-reaper-worker

### gitterm-caddy-proxy https://upload.wikimedia.org/wikipedia/commons/e/e5/Caddyserver_logo_-_no_wordmark.svg

- **Image:** ghcr.io/opeoginni/gitterm-proxy
- **Public domain:** Yes

## Documentation

GitTerm lets you run OpenCode in remote, persistent workspaces you can reopen from anywhere. It ships with a web app, API, proxy, worker, Postgres, and Redis, and works across multiple infrastructure backends with more provider support on the way. Deploy it on Railway, add your admin login, then configure workspace providers from the app. Use path routing for a standard single domain, or subdomain routing if you have wildcard domain support on the proxy.

## What You Need

Required:

- `ADMIN_EMAIL`
- `ADMIN_PASSWORD`

Optional later:

- GitHub OAuth credentials for sign-in
- GitHub App credentials for repository access
- Provider credentials for Railway, AWS, E2B, Cloudflare, and future providers

Provider configuration is done inside the GitTerm admin UI, not in the template form.

## Routing

### Path Routing

Best when you only have a single normal domain on the proxy.

- `https://your-domain.com/` -> app
- `https://your-domain.com/api/` -> API
- `https://your-domain.com/listener/` -> listener
- `https://your-domain.com/ws//` -> workspaces

### Subdomain Routing

Use this only if your proxy domain has wildcard DNS and wildcard TLS support.

- `https://-.your-domain.com`

If you are unsure, use path routing.

## Startup Behavior

On startup, the server automatically:

1. runs database migrations
2. seeds built-in app data
3. creates or upgrades the admin user when `ADMIN_EMAIL` and `ADMIN_PASSWORD` are set

## Services Included

- `web`
- `server`
- `listener`
- `worker`
- `proxy`
- PostgreSQL
- Redis


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/gitterm