Home

Maurice PaaS Wiki

Maurice is a single-server deployment platform built on rootless Podman, Quadlet and systemd. This wiki holds the full plan, the architecture and the operating guides. Status: Alpha works end to end; see the Alpha Guide. The repository README is the short introduction; start there if you are new.

The plan

Page	What it covers
Goals and Scope	The problem, who it is for, what is deliberately out of scope
Principles	Eight rules every design decision is checked against
Architecture	Components, flow, isolation model, networking, zero-downtime deploy
Data Model	Core entities and the fields that drive Quadlet generation
Roadmap	Alpha → MVP → Beta → Release with scope, done criteria and risks
Feature Matrix	One table: which area lands in which stage
Open Decisions	Questions still to be decided, with options and deadlines
Technology Stack	What each layer is built with and why

Design deep dives

Page	What it covers
Prior Art	Coolify, Dokploy, Rookery and others: what we borrow from each
Remote Development	Dev workspaces on the server: toolchain, editors, tunnels
Agent Memory	Entire checkpoints and how agent sessions link to deployments
Task Tracker	Plane integration and the decomposition rules the agent enforces
Telemetry	Metrics, logs and the workspace timeline

Working on the project

Page	What it covers
Contributing	Language, commit format, branch workflow, parallel sessions
Task board	Live status of every task
Issues	Tasks, decisions and spikes
Architecture decisions	ADRs, versioned with the code

Guides

Page	What it covers
Alpha Guide	What works today, installation on a host, browser walkthrough with screenshots, CLI walkthrough, known limits

Operations and recovery guides follow with MVP.

---

Based on the Maurice PaaS plan v0.4 (22 October 2026). Pages are updated as decisions are made and stages complete.