Project Lifecycle
The verbs that discover, register and run projects.
Discovery
Section titled “Discovery”Find compose files under a directory (read-only).
mdocker scan # default path ~/Projects, max depth 4mdocker scan ~/clients --jsondetect
Section titled “detect”Run the profile heuristic against a compose file (read-only).
mdocker detect ~/Projects/aurora/docker-compose.ymlRegistration
Section titled “Registration”Register a project.
mdocker init <path> [--name N] [--profile P] [--host H …]Writes overrides/<name>.override.yml, updates registry.json, and patches
.docker/proxy/*.conf for dockware projects. --host may be repeated.
Running
Section titled “Running”Start a project.
mdocker up <name> [--auto-remap-ports] [--no-port-check]Runs the port pre-flight, then starts the containers; may persist port_overrides
and write overrides/<name>.ports.yml.
Stop a project (overrides preserved).
mdocker down <name>Also stops that project’s public tunnels.
restart
Section titled “restart”docker compose restart. Does not re-render overrides or re-attach to a recreated
edge network — use cycle for that.
mdocker restart <name>Robust full restart after a runtime update.
mdocker cycle # previously-running projectsmdocker cycle --all # every registered projectStops running projects → edge down + edge up → up <name> --auto-remap-ports
(recreate) for the previously-running projects. Continues on per-step failure;
returns non-zero if anything failed.
Inventory & inspection
Section titled “Inventory & inspection”ls / list
Section titled “ls / list”Registry overview (read-only).
mdocker lsmdocker ls --jsonTail project logs (read-only).
mdocker logs <name> [--service S …] [--grep PAT] [--since DUR] [--tail N] [-f]Management
Section titled “Management”Unregister a project — deletes its override and removes it from the registry.
mdocker rm <name>Also stops that project’s tunnels.
rename / mv
Section titled “rename / mv”Rename a project (must be stopped). Renames the override and registry entry.
mdocker rename <old> <new>rerender
Section titled “rerender”Regenerate the override from current registry state.
mdocker rerender <name>fix-proxy
Section titled “fix-proxy”Patch a dockware project’s proxy .conf files, and restart the proxy if running.
mdocker fix-proxy <name>Related
Section titled “Related”Cookie settings
We only use statistics tools if you allow it. Necessary storage keeps this site working; everything else is off until you decide.
Stores your choice from this dialog in your browser (localStorage). No cookie, no transfer to third parties.
Google Analytics 4 via Google Tag Manager, to measure how the site is used. Loaded only after you allow it.