Sign inSign up

baeroe/werkbuch

By baeroe

•Updated about 16 hours ago

Self-hosted project management: custom types, workflows, views, wiki, REST API, MCP, webhooks

Image
0

716

baeroe/werkbuch repository overview

⁠werkbuch

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/werkbuch on Docker Hub. The concept is in docs/superpowers/specs/2026-10-28-werkbuch-design.md⁠ (German), a clickable prototype with demo data in prototypes/clickdummy/⁠ (German UI).

⁠Screenshots

The board of a project, its work items in one column per status

The page of a work item with its description, fields, relations and activity

The command palette searching work items, wiki pages and projects

⁠Self-hosting

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.

⁠Development

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.

⁠Stack

Laravel, Inertia and React with a custom UI, MariaDB, Meilisearch, Laravel Reverb. Shipped as a Docker image with a Compose stack.

⁠License

MIT⁠

Tag summary

Content type

Image

Digest

sha256:c1294cedf…

Size

212 MB

Last updated

about 16 hours ago

docker pull baeroe/werkbuch