Voraussetzungen

MultiDocker ist auf macOS ausgerichtet. Der DNS-Resolver und das TLS-Trust, die es einrichtet, sind macOS-spezifisch; Linux ist möglich, aber das DNS-Setup muss von Hand erfolgen, und Windows ist außerhalb des Umfangs.

System

• macOS (Apple Silicon oder Intel).
• Eine Container-Runtime — OrbStack (empfohlen) oder Docker Desktop.
• Homebrew, um die untenstehenden CLI-Tools zu installieren.

Container-Runtime: OrbStack vs. Docker Desktop

OrbStack (empfohlen)

OrbStack ist die empfohlene Runtime. Jeder Container ist automatisch vom Host aus unter <service>.<project>.orb.local erreichbar, was den Datenbank-Zugriff trivial macht — kein manuelles Port-Mapping nötig.

Docker Desktop

Docker Desktop funktioniert auch, aber Host-DNS in Container ist nicht verfügbar. Um eine Datenbank vom Host zu erreichen, musst du einen Port temporär mappen. Alles andere verhält sich gleich.

CLI-Tools

MultiDocker verlässt sich auf eine Handvoll Kommandozeilen-Tools:

Tool	Wozu es gebraucht wird
mkcert	Erzeugt und vertraut das lokale Wildcard-TLS-Zertifikat.
nss	Lässt mkcert seine CA in Firefox-/NSS-Trust-Stores installieren.
yq (mikefarah v4)	Parst und schreibt Compose-YAML beim Rendern der Overrides um.
jq	Liest und schreibt die JSON-Registry und Befehlsausgaben.
openssl	Zertifikats-Helfer, der beim TLS-Setup verwendet wird.

Installiere sie in einem Rutsch mit Homebrew:

brew install

brew install mkcert nss yq jq

yq muss die mikefarah-Variante sein

Es gibt zwei verschiedene Tools namens yq. MultiDocker braucht mikefarahs yq v4 (die Go-Implementierung, installiert durch brew install yq), nicht den Python-yq-Wrapper um jq. Prüfe mit yq --version.

Optionale Tools

• cloudflared — nur für öffentliche Demo-Tunnels (mdocker share) nötig. Installiere mit brew install cloudflared.
• tmux — erforderlich für AI-Terminal-Sessions.
• TablePlus — ein schönes Ziel für mdocker db open, aber jeder Client funktioniert.

Tipp

Du musst dir diese Liste nicht merken. Nach der Installation prüft mdocker doctor jedes erforderliche Tool und sagt dir, was fehlt — siehe mdocker doctor ausführen.

Weiter

Weiter zur Installation.