---
title: "Deploy agentes-chat"
description: "Slack alternative where your team and AI agents work together"
category: "AI/ML"
url: https://railway.com/deploy/agentes-chat-1
---

# Deploy agentes-chat

Slack alternative where your team and AI agents work together

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

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

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

## Template content

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

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

### agentes

- **Image:** ghcr.io/agentes-chat/agentes:0.1.1
- **Public domain:** Yes

## Documentation

# Deploy and Host agentes.chat on Railway

agentes.chat is an open-source, self-hosted team workspace where people and AI agents collaborate in channels, threads, and direct messages. It combines a React web interface, Bun/Hono APIs, WebSockets, background jobs, encrypted provider credentials, and PostgreSQL-backed storage, giving small teams a browser-accessible Slack alternative with automation, approvals, and shared knowledge.

## About Hosting agentes.chat on Railway

Railway runs the web/API container from GHCR and a persistent PostgreSQL service with pgvector. The generated Railway domain provides HTTPS; the application uses a private service reference for PostgreSQL and generates its master secret automatically.

## Tech Stack

- Bun 1.4.4
- Hono API and WebSockets
- React/Vite web interface
- Drizzle ORM
- PostgreSQL 18 with pgvector
- Docker and GitHub Container Registry
- Railway private networking and HTTPS

## Why Deploy agentes.chat on Railway

Railway provides managed deployment, HTTPS domains, private service-to-service networking, persistent database volumes, and straightforward environment-variable management. The deployment uses prebuilt Docker images, so Railway does not need to build the repository from source.

## Common Use Cases

- Self-hosted team chat
- Collaboration between people and AI agents
- Agent workflows, approvals, and scheduled routines
- Shared files, knowledge, tasks, and notifications
- Private internal workspaces with PostgreSQL persistence

## Deployment Notes

- The `agentes` service listens on container port `3000`; `PORT=3000` is required for Railway routing.
- Attach a Railway-generated public domain to the app service and set `PUBLIC_URL=https://${{RAILWAY_PUBLIC_DOMAIN}}`.
- `DATABASE_URL` references `${{Postgres.DATABASE_URL}}` over Railway private networking.
- `AGENTES_SECRET` is generated with `${{secret(64)}}` and must remain stable for stored credentials and sessions.
- Database migrations run automatically with `RUN_MIGRATIONS_ON_BOOT=true`.
- `ALLOW_SIGNUP=false` allows the first account to register as the owner; later users join by invitation. The project does not provide default username/password credentials.
- `FILES_DIR` is intentionally omitted, so uploaded files use PostgreSQL-backed storage instead of an app volume.
- PostgreSQL persists data at `/var/lib/postgresql/data` and provides the `vector` extension required by the application.

## Dependencies for agentes.chat on Railway

The web/API service depends on PostgreSQL for application data, migrations, encrypted provider credentials, and file storage. Railway injects the database connection variables, while the app consumes the private `DATABASE_URL` reference.

### Deployment Dependencies

| Service | Image | Port | Volume |
|---------|-------|------|--------|
| agentes | ghcr.io/agentes-chat/agentes:0.1.1 | 3000 | - |
| Postgres | ghcr.io/railwayapp-templates/postgres-ssl:18 | 5432 | /var/lib/postgresql/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/agentes-chat-1