Deploy wemux-community

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:

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):

   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

> ⚠️ 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.