Erst-Setup

Führe das einmal nach der Installation aus. Ein einziger Befehl richtet alles ein, was die Projekte gemeinsam nutzen müssen.

one-time setup

mdocker setup

Was mdocker setup macht

setup läuft vier Phasen der Reihe nach durch:

Phase	Skript	Wirkung
Netzwerk	setup-network.sh	Erstellt das multi-docker-edge-Docker-Netz.
TLS	setup-tls.sh	Installiert die mkcert-CA und schreibt ein Wildcard-Zertifikat für *.<base-domain>.
DNS	setup-dns.sh	Schreibt /etc/resolver/<base-domain>, damit die Domain zum lokalen dnsmasq auflöst.
Edge	edge up	Startet Traefik, Mailcatcher, dnsmasq und den docker-socket-proxy.

sudo wird einmal abgefragt

Das Schreiben von /etc/resolver/<base-domain> erfordert Administrator-Rechte, daher fragt setup während der DNS-Phase einmal nach deinem Passwort. Sonst braucht nichts sudo.

Verifizieren, dass es geklappt hat

1. Führe den Health-Check aus. doctor inspiziert die Toolchain und den State (CA installiert, Resolver vorhanden, Edge-Netz, Ports 80/443):

   mdocker doctor

   mdocker doctor

2. Bestätige, dass der Edge-Stack läuft:

   mdocker edge status

   mdocker edge status

3. Öffne die Mailcatcher-UI, um zu beweisen, dass Routing und TLS durchgängig funktionieren:

   mail UI

   open https://mail.coding9.test

Zertifikate überleben Updates

Der Zertifikats-Store liegt bewusst unter ~/.config/multi-docker/certs/, sodass Runtime-Updates ihn nie überschreiben oder löschen. Wenn du die Basis-Domain später mit mdocker config set BASE_DOMAIN … änderst, werden Zertifikat, Resolver, Overrides und Edge-Stack automatisch neu erzeugt.

Weiter

Du bist bereit, etwas laufen zu lassen. Weiter zum Quickstart.