---
title: "Deploy agenticos"
description: "AI agent platform for your company's AI teammates on your own servers"
category: "AI/ML"
url: https://railway.com/deploy/agenticos-1
---

# Deploy agenticos

AI agent platform for your company's AI teammates on your own servers

**[Deploy agenticos on Railway](https://railway.com/template/agenticos-1)**

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

- **Creator:** kmaki's Projects
- **Category:** AI/ML

## Template content

### app

- **Image:** ghcr.io/vstorm-co/agenticos-backend:1.89.1
- **Public domain:** Yes

### frontend

- **Image:** ghcr.io/vstorm-co/agenticos-frontend:1.89.1
- **Public domain:** Yes

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# Deploy and Host AgenticOS on Railway

AgenticOS is a self-hosted platform for building, running, and governing AI agents. It provides a web console, shared conversations, retrieval-augmented knowledge, MCP integrations, budgets, approvals, and audit history. Teams keep their data and provider credentials under their own control while configuring reusable agents through a browser-based workspace.

## About Hosting AgenticOS on Railway

Railway runs the AgenticOS console and API from pinned GHCR images, with PostgreSQL and Redis as private supporting services. Railway provides managed networking, public HTTPS domains, persistent volumes, and straightforward environment-variable wiring between services.

## Tech Stack

- FastAPI and Python backend
- Next.js and Bun frontend
- PostgreSQL with the pgvector extension
- Redis-compatible cache and queue service
- Pydantic AI agent runtime
- MCP integrations and retrieval-augmented generation
- Railway private networking, domains, and volumes

## Why Deploy AgenticOS on Railway

Railway provides a fast path to a running self-hosted AI workspace without building the application locally. Pinned container images make releases reproducible, private service references keep database traffic off the public internet, and persistent volumes preserve PostgreSQL, Redis, and uploaded media data.

## Common Use Cases

- Internal AI assistants for company teams
- Document question answering and knowledge search
- MCP-based access to SaaS tools
- Governed agents with budgets and approvals
- Shared chat and reusable agent workspaces
- API access to published agents

## Deployment Notes

The public frontend listens on port 3000 and the backend API listens on port 8000. The frontend uses the app service's private Railway domain for server-side requests and the app's public domain for browser API and WebSocket traffic. PostgreSQL must retain its `/var/lib/postgresql/data` volume and includes the `vector` extension. Redis uses `/data` and password authentication. The app persists uploaded media at `/app/media`; after attaching a new Railway volume, ensure it is owned by UID/GID 1000 (`appuser`). The app startup runs migrations and an idempotent bootstrap using `ADMIN_USERNAME` and `ADMIN_PASSWORD`. Provider keys are added later through AgenticOS settings.

## Dependencies for AgenticOS on Railway

AgenticOS requires PostgreSQL with pgvector and Redis for application state, sessions, caching, and background coordination. The frontend communicates with the backend over Railway private networking while users access the frontend through its public HTTPS domain.

### Deployment Dependencies

| Service | Image | Port | Volume |
|---------|-------|------|--------|
| app | ghcr.io/vstorm-co/agenticos-backend:1.89.1 | 8000 | /app/media |
| frontend | ghcr.io/vstorm-co/agenticos-frontend:1.89.1 | 3000 | - |
| Postgres | ghcr.io/railwayapp-templates/postgres-ssl:18 | 5432 | /var/lib/postgresql/data |
| Redis | redis:8.2 | 6379 | /data |

## 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/agenticos-1
