Deploy Agent Swarm
Self-hosted Agent Swarm: API, agent-fs, TEI, a lead and two coders
Just deployed
/data
Just deployed
/workspace/personal
Just deployed
/workspace/personal
Just deployed
/workspace/personal
Just deployed
/app/data
agent-fs
Just deployed
/data
Deploy and Host Agent Swarm on Railway
Agent Swarm runs a team of AI coding agents that you direct from a dashboard. A lead agent plans and delegates work, and coder agents execute it in their own workspaces. This template starts the API, a file store, an embedding server, a lead and two coders.
About Hosting Agent Swarm
The api service holds the task queue, the SQLite database and the dashboard connection, and it is the only service with a public domain. The agent-fs service stores files the agents share, and tei serves the embeddings that power agent memory. The lead, coder-1 and coder-2 services run the agents and reach the API over Railway's private network. Each service keeps its data on its own volume.
After the deploy, open https://app.agent-swarm.dev/setup?apiUrl=https://&apiKey= once the api service is healthy. The domain is on the api service's Settings tab, and API_KEY is on its Variables tab. Add your Claude, OpenAI or OpenRouter credential on /setup. Agents wait until a credential exists.
Common Use Cases
- Run a self-hosted agent team that works on your repositories around the clock
- Delegate coding, review and research tasks from Slack, GitHub or the dashboard
- Give your agents shared memory and files without running the infrastructure yourself
Dependencies for Agent Swarm Hosting
ghcr.io/desplega-ai/agent-swarm,agent-swarm-workerandagent-fsimages, plus the Hugging Face text-embeddings-inference image- A Hobby plan or higher: the worker image is about 8 GB unpacked, and this template uses six volumes
- A Claude, OpenAI or OpenRouter credential, added on
/setupafter the deploy
Why Deploy Agent Swarm 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 Agent Swarm 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
