Deploy Suparagent
Self-hosted AI coworkers: agents with memory, routines and your approval
Suparagent
Just deployed
/data
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 & privacy → People.
TOKEN_ENCRYPTION_KEYSis 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_PASSPHRASEand redeploy. - Agents can run (
LOCAL_EXECUTION_ENABLED=true). File edits and commands stay off until you setLOCAL_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_URLtohttps://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.
Template Content
Suparagent
aalfath/suparagent-railway-template
