---
title: "Deploy Suparagent"
description: "Self-hosted AI coworkers: agents with memory, routines and your approval"
category: "AI/ML"
url: https://railway.com/deploy/suparagent
---

# Deploy Suparagent

Self-hosted AI coworkers: agents with memory, routines and your approval

**[Deploy Suparagent on Railway](https://railway.com/template/suparagent)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/suparagent/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** AI/ML

## Template content

### Suparagent https://raw.githubusercontent.com/Anil-matcha/suparagent/main/desktop/build/icon.png

- **Source:** https://github.com/aalfath/suparagent-railway-template
- **Health check:** /api/v1/health
- **Public domain:** Yes

## Documentation

# Deploy and Host Suparagent on Railway

Suparagent is an open-source, self-hosted workspace for AI coworkers. You create named agents, give each one instructions, memory, routines and its own workspace, and bring them together on real tasks. Agents ask for your approval before they act. You bring your own engine: Claude Code, Codex, Gemini, OpenRouter or any OpenAI-compatible API.

## About Hosting Suparagent

Suparagent's server is one Python process that also serves the web app. It keeps everything in SQLite and a few folders on a persistent volume, and needs an encryption key, an owner passphrase and a reverse proxy that passes the visitor's address and HTTPS scheme. This template builds the official image, pinned by digest, from a GitHub repo. It puts `/data` on a volume and generates the key and the passphrase. Railway's edge is the trusted proxy, so sign-in cookies are `Secure` and failed sign-ins lock out the right visitor. It also bundles the Claude Code and Codex CLIs, which you sign in to from Settings.

## Common Use Cases

* A shared team of AI agents with their own instructions, memory and approval rules, reachable from any browser or a paired device
* Scheduled routines and webhooks that run agents on a timetable, for example weekly project briefings
* Running Claude Code, Codex or an OpenRouter model on a server instead of a laptop, with every command waiting for approval

## Dependencies for Suparagent Hosting

* An engine account: a Claude or ChatGPT account for the bundled CLIs, or an API key for OpenRouter, Gemini or an OpenAI-compatible endpoint
* A Railway volume for the database, attachments, workspaces and engine sign-ins (included)

### Deployment Dependencies

* Suparagent source and docs: https://github.com/Anil-matcha/suparagent
* Self-hosting guide: https://github.com/Anil-matcha/suparagent/blob/main/docs/SELF-HOSTING.md
* Release v0.8.7: https://github.com/Anil-matcha/suparagent/releases/tag/v0.8.7
* Template source: https://github.com/aalfath/suparagent-railway-template

### Implementation Details

After the deploy, open the public URL, choose **Sign in** and enter `SUPARAGENT_OWNER_PASSPHRASE` from the service's **Variables** tab. Then connect an engine in **Settings → Engines** and invite teammates in **Settings → Account &amp; privacy → People**.

* `TOKEN_ENCRYPTION_KEYS` is a generated Fernet key. Keep a copy: backups don't contain it, and changing it makes saved credentials unreadable.
* To reset a forgotten passphrase, change `SUPARAGENT_OWNER_PASSPHRASE` and redeploy.
* Agents can run (`LOCAL_EXECUTION_ENABLED=true`). File edits and commands stay off until you set `LOCAL_TOOLS_ENABLED=true`, and each command still asks for approval. Agent computers (Docker) aren't available on Railway.
* With a custom domain, set `SUPARAGENT_PUBLIC_URL` to `https://YOUR-DOMAIN`.
* Upstream marks its releases as pre-releases. Updates to this template arrive as Railway update notices, and each one is listed in the repo's CHANGELOG.

## Why Deploy Suparagent 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 Suparagent 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.
- [Weaviate](https://railway.com/deploy/weaviate-1) — Vector database with hybrid search and an API key-protected API
- [Möbius Personal AI OS](https://railway.com/deploy/mobius-v01-personal-ai-os) — Self-hosted AI agent that builds and runs apps for you, with memory.

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