Deploy and Host Super Agent Party on Railway

Super Agent Party is an all-in-one, self-hosted AI companion and agent platform: chat with any LLM, give agents tools (MCP servers, web search, code execution, knowledge bases/RAG), schedule autonomous tasks, run a Live2D/VRM desktop-pet style companion, and connect it to bots and streaming platforms.

About Hosting Super Agent Party

This template deploys the official Docker setup, adapted for Railway:

Service	Image	Purpose
backend	`ailm32442/super-agent-party`	The Super Agent Party app (port 3456, private only). Persistent volume at `/app/data` stores the SQLite DB, settings, knowledge bases and logs
gateway	`ailm32442/nginx-for-sap`	Public entry point: nginx + login/auth service with captcha. Persistent volume at `/data` keeps password changes

The backend is never exposed publicly — every request goes through the authenticated gateway over Railway's private network.

After deploy:

Open the gateway domain.
Log in with username admin and the password from the gateway service's INIT_PASS variable (generated randomly for your deployment).
Change the password in the UI, then add your model provider (OpenAI, Anthropic, Gemini, DeepSeek, Ollama, any OpenAI-compatible API…) in Settings.

Common Use Cases

Personal AI assistant with tools, MCP servers, memory and knowledge bases
AI companion / VTuber-style character with Live2D or VRM avatars and TTS
Scheduled autonomous agent tasks and bot integrations (QQ, Discord, Telegram, live streaming)
A private, multi-model chat workspace you can reach from any device

Dependencies for Super Agent Party Hosting

Docker images ailm32442/super-agent-party and ailm32442/nginx-for-sap
An API key for at least one LLM provider (configured in the UI after login)

Deployment Dependencies

Source: https://github.com/heshengtao/super-agent-party
Official Docker Compose: https://github.com/heshengtao/super-agent-party/blob/main/docker-compose.yml

Implementation Details

The gateway's nginx config hard-codes the upstream backend:3456; the template's start command rewrites it to the backend's Railway private domain (BACKEND_HOST) at boot. Gateway variables: INIT_USER, INIT_PASS (initial credentials), JWT_SECRET (session signing, generated), and optional FORCE_RESET=true to reset the admin password to INIT_PASS on next start.

Why Deploy Super Agent Party 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 Super Agent Party 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.