Deploy agentes-chat

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