---
title: "Deploy wemux-community"
description: "Self-hostable AI agent collaboration platform"
category: "AI/ML"
url: https://railway.com/deploy/wemux-community
---

# Deploy wemux-community

Self-hostable AI agent collaboration platform

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

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

## Template content

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

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

### wemux-community

- **Source:** https://github.com/wemux-ai/wemux
- **Public domain:** Yes

## Buckets

- **wemux-assets**

## Documentation

# Deploy and Host Wemux — Self-Hostable AI Agent Collaboration Platform

Deploy your own Wemux control plane + Postgres on Railway in ~5 minutes. Wemux is a self-hostable AI agent platform: coding agents (Claude Code, Codex, OpenCode) execute tasks in isolated worktrees on your own machines, while the control plane coordinates projects, tasks, chat and GitHub integration.

## About Hosting

Wemux is open source (Apache-2.0) and designed for self-hosting. This template provisions:

| Resource | Purpose |
|---|---|
| **control-plane** | Hono-based server: web console, WebSocket, task scheduling, GitHub integration, chat |
| **Postgres** | Primary database — Drizzle migrations run automatically on first boot |

The worker (the code executor) runs on **your own machines**, not in the cloud — you install it after deploy and pair it with the pairing code shown in the console. This keeps your code, credentials and execution fully under your control.

## Why Deploy

- **Full control**: your data, your workers, your models (BYOK — bring your own API keys)
- **Self-contained**: no vendor lock-in; move to Docker Compose or any VPS anytime
- **Team collaboration**: tasks, workspaces, chat, GitHub PR workflow, Drive storage
- **Open source**: Apache-2.0, active development, community contributions welcome

## Common Use Cases

- Team task board with AI agent execution (kanban → worktree → diff → review → merge)
- Self-hosted alternative to hosted agent platforms, keeping code on your infra
- Multi-node execution across your team's machines via pairing
- Building custom agent workflows with channel integrations (Feishu, Slack, Discord, DingTalk, WeChat, WhatsApp)

## Dependencies for

### Deployment Dependencies

- No Docker or VPS needed — Railway builds from the repo root `railway.json` (RAILPACK)
- Postgres is provisioned by the template (auto-injected `DATABASE_URL`)
- Optional: Cloudflare R2 or MinIO for object storage (avatars / images / Drive) — the control plane falls back to local storage otherwise

## After deploy

1. Open your `*.up.railway.app` URL (HTTPS auto-provisioned) and create an account
2. Settings → Execution Nodes → copy the **pairing code**
3. Install the worker on your machine (macOS / Linux / Windows):
   ```bash
   curl -fsSL https://YOUR-RAILWAY-DOMAIN/install | bash
   # Windows: https://YOUR-RAILWAY-DOMAIN/install.ps1
   ```
4. Pair the worker (`wemux worker pair <code>`), then create a project and assign tasks

## Required variables

Template pre-fills defaults; set the secrets:

- `BETTER_AUTH_SECRET` — `openssl rand -hex 32`
- `TOKEN_SECRET` — `openssl rand -hex 32`
- `SECRET_ENCRYPTION_KEY` — `openssl rand -hex 32`

Then update `WEMUX_PUBLIC_BASE_URL` / `BETTER_AUTH_URL` to your domain (defaults to the Railway domain) and redeploy.

## Object storage (optional but recommended)

The template includes a **Bucket** resource (`wemux-assets`, S3-compatible). To enable avatars / images / Drive:

1. In the project, open the **wemux-assets** bucket → **Credentials** and copy the 4 values
2. Add them to the `wemux-community` service variables:
   - `OBJECT_STORAGE_ENDPOINT` = the endpoint URL
   - `OBJECT_STORAGE_BUCKET` = the bucket name
   - `OBJECT_STORAGE_ACCESS_KEY_ID` = access key
   - `OBJECT_STORAGE_SECRET_ACCESS_KEY` = secret key
   - `OBJECT_STORAGE_REGION` = `auto`
3. Redeploy

Alternatively use any S3-compatible provider (Cloudflare R2, MinIO, AWS S3) with the same variables.

## Docs

- Full self-hosting guide: https://github.com/wemux-ai/wemux/blob/main/docs/SELF-HOSTING.md
- Open-source repo: https://github.com/wemux-ai/wemux

&gt; ⚠️ This is the community/self-hosted edition. The hosted commercial service (wemux.ai) adds managed cloud nodes, billing and partner features not included in the open-source repo.
</code>

## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/wemux-community