---
title: "Deploy trueforge"
description: "Hosted TrueForge: agent harness with UI, Postgres & Redis"
category: "AI/ML"
url: https://railway.com/deploy/trueforge-1
---

# Deploy trueforge

Hosted TrueForge: agent harness with UI, Postgres & Redis

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

- **Creator:** Abhishek Choudhary's Projects
- **Category:** AI/ML

## Template content

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

- **Image:** redis:8.2
- **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:18

### trueforge https://raw.githubusercontent.com/truefoundry/trueforge/main/docs/assets/trueforge-black.svg

- **Source:** https://github.com/truefoundry/trueforge
- **Health check:** /healthz
- **Public domain:** Yes

## Documentation

# Deploy and Host TrueForge with Railway

TrueForge is an open-source agent harness — the runtime that turns an LLM into a working agent. It runs model calls, MCP tools, skills, sandboxing, approvals, and session state, and exposes them as a chat UI, HTTP API / TypeScript SDK, and embeddable UI SDK. This template deploys hosted TrueForge with Postgres and Redis on Railway.

## About Hosting TrueForge

Hosted TrueForge runs as three Railway services: the app server (chat UI + HTTP API, built from source via `Dockerfile.dev`), Postgres for durable sessions and turns, and Redis for streaming and multi-replica coordination. `DATABASE_URL`, `REDIS_URL`, and `PUBLIC_BASE_URL` are wired automatically; Railway injects `PORT`. After deploy, generate a public domain on the `trueforge` service. Login is off by default — anyone who can reach the URL is admin — so enable OIDC before sharing beyond personal use. Redirect URI: `https:///api/v1/auth/callback`.

## Common Use Cases

- Personal or team agent workspace with a hosted chat UI
- Prototyping agents that use MCP tools, skills, and sandboxed code execution
- Backend for apps that drive sessions and turns via the HTTP API or TypeScript SDK
- Embedding agent chat in a product with `@truefoundry/trueforge-ui`

## Dependencies for TrueForge Hosting

- **Postgres** — session and turn persistence (included)
- **Redis** — stream fan-out and cancellation across replicas (included)
- **Public domain** — UI and OIDC / MCP OAuth callbacks (`PUBLIC_BASE_URL`)
- **Model provider credentials** — configured in Initial Setup after deploy
- **Optional OIDC IdP** — confidential (Web) app for team login

### Deployment Dependencies

- [TrueForge documentation](https://trueforge.dev)
- [Quickstart](https://trueforge.dev/quickstart)
- [Setup Login (OIDC)](https://trueforge.dev/authentication/overview)
- [API / SDK](https://trueforge.dev/api/overview)
- [GitHub repository](https://github.com/truefoundry/trueforge)
- [Railway Infrastructure as Code](https://docs.railway.com/infrastructure-as-code)

### Why Deploy TrueForge 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 TrueForge 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.

## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/trueforge-1