Zum Inhalt springen

Project Lifecycle

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

The verbs that discover, register and run projects.

Find compose files under a directory (read-only).

mdocker scan
mdocker scan # default path ~/Projects, max depth 4
mdocker scan ~/clients --json

Run the profile heuristic against a compose file (read-only).

mdocker detect
mdocker detect ~/Projects/aurora/docker-compose.yml

Register a project.

mdocker init
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.

Start a project.

mdocker up
mdocker up <name> [--auto-remap-ports] [--no-port-check]

Pre-flight before anything starts: if the override still lists a service the compose file no longer has (say, an API container you removed), the override is regenerated automatically — Compose would otherwise reject the whole project with service "api" has neither an image nor a build context. Then the edge stack is started if needed, the routing and port checks run, and the containers come up; the port check may persist port_overrides and write overrides/<name>.ports.yml. restart runs the same override check.

Stop a project (overrides preserved).

mdocker down
mdocker down <name>

Also stops that project’s public tunnels.

docker compose restart. Does not re-render overrides or re-attach to a recreated edge network — use cycle for that.

mdocker restart
mdocker restart <name>

Robust full restart after a runtime update.

mdocker cycle
mdocker cycle # previously-running projects
mdocker cycle --all # every registered project

Stops 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.

Registry overview (read-only).

mdocker ls
mdocker ls
mdocker ls --json

Plain text prints NAME, STATUS, HOSTNAME(S) and PFAD. The --json form is an array with one object per project, carrying name, path, profile, hostnames, hostname (the first one, kept for backwards compatibility), created, ai_session_path, editor_path, routing, spedy, group, port_overrides and status. Optional fields are null when unset — group without a group assignment, spedy without a board assignment.

Tail project logs (read-only).

mdocker logs
mdocker logs <name> [--service S …] [--grep PAT] [--since DUR] [--tail N] [-f]

Unregister a project — deletes its override and removes it from the registry.

mdocker rm
mdocker rm <name>

Also stops that project’s tunnels.

Rename a project (must be stopped). Renames the override and registry entry.

mdocker rename
mdocker rename <old> <new>

Regenerate the override from current registry state.

mdocker rerender
mdocker rerender <name>

Patch a dockware project’s proxy .conf files, and restart the proxy if running.

mdocker fix-proxy
mdocker fix-proxy <name>