Self-hosted project management: custom types, workflows, views, wiki, REST API, MCP, webhooks
716
Project management you host yourself: work items with your own types, fields and workflows, a wiki per project, team-wide views across projects, recurring work from templates and switchable automations. Made for the keyboard, and open to scripts and AI agents through a REST API, an MCP server and webhooks. The docs are at https://werkbuch.dev.
Status: v0.3.0 is the current release, the image is
baeroe/werkbuchon Docker Hub. The concept is indocs/superpowers/specs/2026-10-28-werkbuch-design.md (German), a clickable prototype with demo data inprototypes/clickdummy/ (German UI).



werkbuch runs as a Docker Compose stack: the image baeroe/werkbuch (web service, Reverb for live updates, three queue workers, the scheduler) with MariaDB 11.4 and Meilisearch 1.56, everything behind one port (7740). You need Docker with Compose v2.20 or newer, 2 vCPU and 2 GB of RAM (4 GB recommended).
curl -fsSLO https://raw.githubusercontent.com/baeroe/werkbuch/main/docker-compose.yml
curl -fsSL -o .env https://raw.githubusercontent.com/baeroe/werkbuch/main/.env.docker.example
# edit .env: APP_URL, ADMIN_EMAIL, ADMIN_PASSWORD, DB_PASSWORD, DB_ROOT_PASSWORD, MEILISEARCH_KEY
docker compose up -d
Put a reverse proxy with HTTPS in front, set APP_URL to its address and sign in with ADMIN_EMAIL and ADMIN_PASSWORD. For Dockge or Portainer there is docker-compose.standalone.yml, one file without .env.
Local development runs in DDEV (PHP 8.4, MariaDB 11.4, Meilisearch, Node 24 with pnpm); the guide is the development page. The docs live in docs/ (VitePress, English and German) and are published at https://werkbuch.dev; locally: ddev exec pnpm --dir docs dev.
Laravel, Inertia and React with a custom UI, MariaDB, Meilisearch, Laravel Reverb. Shipped as a Docker image with a Compose stack.
Content type
Image
Digest
sha256:c1294cedf…
Size
212 MB
Last updated
about 16 hours ago
docker pull baeroe/werkbuch