Häufige Probleme

Die meisten Probleme fallen in eine Handvoll Kategorien. Finde dein Symptom unten; wenn es nicht dabei ist, starte mit mdocker doctor, das all diese automatisch diagnostiziert.

Symptom → Ursache → Lösung

Symptom	Ursache	Lösung
bind: address already in use auf 80/443	Ein fremder Prozess (Apache, nginx, ein anderer Proxy) hält den Port	mdocker doctor nennt den störenden Prozess — stoppe ihn, oder mdocker edge down
Browser zeigt NET::ERR_CERT_AUTHORITY_INVALID	Die mkcert-CA ist nicht in deinem Trust-Store installiert	mkcert -install, dann den Browser neu starten
Hostname lädt nicht (“connection refused” / nicht aufgelöst)	Der DNS-Resolver fehlt oder ist inaktiv	Stelle sicher, dass /etc/resolver/<base-domain> nameserver 127.0.0.1 enthält; andernfalls mdocker setup-dns (oder bash scripts/setup-dns.sh) ausführen
Container startet nicht mit network multi-docker-edge not found	Das Edge-Docker-Netz existiert nicht	mdocker setup-network (oder bash scripts/setup-network.sh)
mdocker up bricht mit Exit-Code 2 ab	Der Port-Preflight fand einen belegten Host-Port und keinen freien Ersatz	Gib den Port frei, oder führe mdocker up <name> --auto-remap-ports (oder --no-port-check) aus
Traefik antwortet nicht / routet an die falsche Stelle	Edge-Stack ist unten, oder die Labels des Projekts sind nicht gesetzt	mdocker edge status, dann mdocker edge logs -f; Projekt mit mdocker rerender <name> neu rendern

Einige davon im Detail

bind: address already in use

MultiDocker bindet die Ports 80, 443 und 53 auf der Loopback-Adresse für seinen Edge-Stack. Wenn ein System-Apache/-nginx, ein anderer Dev-Proxy oder ein verbliebener Container einen davon bereits hält, kann der Edge-Stack nicht starten. mdocker doctor identifiziert den Prozess; stoppe ihn und versuche es erneut.

Certificate authority invalid

Das Wildcard-Zertifikat wird von einer lokalen mkcert-CA ausgestellt. Wenn dein Browser ihr nicht vertraut, ist die CA nicht im System-Trust-Store installiert. Führe mkcert -install aus und starte den Browser vollständig neu (nicht nur den Tab). Das ist auch das, was mdocker setup-tls sicherstellt. Siehe DNS & TLS.

Hostname löst nicht auf

Eine vorhandene-aber-inaktive Resolver-Datei ist die klassische Falle: macOS hat /etc/resolver/<base-domain> möglicherweise noch nicht neu geladen. mdocker doctor verifiziert die tatsächliche Auflösung, also vertraue ihm mehr als „die Datei ist ja da“. Ein erneuter mdocker setup-dns-Lauf leert den Cache und lädt den mDNSResponder neu.

Exit-Code 2 bei up

Das ist der Port-Konflikt-Preflight, der den Start verweigert, weil ein Host-Port, den ein Service will, belegt ist und er keinen freien Ersatz zum automatischen Anwenden finden konnte. Gib entweder den Port frei oder lass MultiDocker ihn mit --auto-remap-ports remappen.

Traefik routet falsch oder stumm

Wenn die Seite eines Projekts durch Traefik 404t oder den falschen Container trifft, läuft entweder der Edge-Stack nicht, oder die generierten Labels des Projekts sind veraltet. Prüfe mdocker edge status, streame mdocker edge logs -f während du neu lädst, und wenn die Labels falsch aussehen, erzeuge das Override mit mdocker rerender <name> neu. Siehe Edge- & Traefik-Logs lesen.

Immer noch fest?

Prüfe die FAQ für die „Warum verhält es sich so“-Fragen — mehrere scheinbare Bugs (wechselnde Tunnel-URLs, App vs. CLI sehen unterschiedliche Projekte) sind bewusste Design-Entscheidungen.