Documentation

Run your own DayMug.

DayMug is an open-source, self-hosted web workspace for the claude and codex agents. One Go binary with an embedded web app and a SQLite database — no Docker, no external database, no cloud account. These pages take you from an empty machine to a team-ready instance.

The 15-minute path

Install the binary One line on a Linux x86_64 or Apple Silicon Mac. It lays out ~/.daymug/ and registers a user-level service. → Install
Check config.yaml Put your username under admin.bootstrap_usernames. Everything else has working defaults. → Editing config.yaml
Start it and create the first admin Open http://127.0.0.1:8090; an empty database walks you through creating the administrator.
Add a provider account Settings → Administration → Providers & models. Point it at a Claude or Codex login (or any Anthropic- / OpenAI-compatible endpoint), add models, check the account. → Providers & models
Invite the team Create users (or turn on SSO), grant them provider accounts, and pick how people reach the server — your own domain and reverse proxy, or LAN. → Users, SSO & sandbox

Where each setting lives

DayMug splits configuration in two on purpose. Things that decide how the process starts live in a YAML file and need a restart. Things an administrator changes day to day live in the database, are edited from the web UI, and apply immediately.

Setting	Where	Applies
Listen address, public URL	`config.yaml` → `server`	after restart
Login methods, session length, SSO	`config.yaml` → `auth`, `oidc`	after restart
Per-turn cost / tool-call guardrails	`config.yaml` → `guardrails`	after restart
Sandbox (bubblewrap)	`config.yaml` → `sandbox`	after restart
Provider accounts, credentials, models, pricing	Settings → Administration → Providers & models	immediately
Users, admin flag, account bindings, sandbox exemptions	Settings → Administration → Users	immediately
Agents and their Slack / 飞书 / Telegram / 微信 bots	Settings → Agents → edit agent	immediately (bots hot-reload)
Your own env vars for agent processes	Settings → Advanced	next turn

Requirements at a glance

OS — Linux x86_64 or macOS on Apple Silicon for the released binaries. Other platforms can build from source.
Node.js 18+ with npm install -g @anthropic-ai/claude-agent-sdk — Claude conversations run on the Agent SDK.
Codex (only if you add a Codex account) — npm install -g @openai/codex, a version that supports codex app-server.
A normal user account — the installer refuses to run as root.
Your own AI plan — a Claude or ChatGPT/Codex subscription, or an API key for a compatible endpoint. DayMug does not resell credits.

Build from source

The whole project lives in one repository: github.com/ifconfiger/DayMug. You need Go 1.25+, Node.js 20+ and pnpm 10+.

build a single binary

git clone https://github.com/ifconfiger/DayMug.git && cd DayMug
cd frontend && pnpm install && pnpm build && cd ..
rm -rf backend/cmd/server/dist && cp -r frontend/dist backend/cmd/server/dist
cd backend && go build -tags embed_frontend -o daymug ./cmd/server

./daymug bootstrap   # lay out ~/.daymug/ and register the service
# or, for a self-contained directory instead of ~/.daymug/:
./daymug init        # writes config.yaml + data/ + users/ here

For hot-reload development (air + pnpm dev), see docs/local-development.md in the repository.