Deploy trueforge

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
• Quickstart
• Setup Login (OIDC)
• API / SDK
• GitHub repository
• Railway 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.