setup & Infrastructure

These verbs provision and verify the shared infrastructure. Run setup once after installation; the individual phases exist for re-running a single part.

setup

Full first-run install. Runs all phases in order.

mdocker setup

mdocker setup

Aspect	Detail
Args / flags	—
Calls	setup-network.sh, setup-tls.sh, setup-dns.sh, then edge up.
Side effects	Creates ~/.config/multi-docker/, certificates, the resolver and the edge containers. Prompts for sudo once (for the resolver).

setup-tls

(Re-)generate the wildcard certificate and install the mkcert CA.

mdocker setup-tls

mdocker setup-tls

Writes wildcard.pem and wildcard-key.pem under the cert store and installs the mkcert CA.

setup-dns

Write the macOS resolver for the base domain.

mdocker setup-dns

mdocker setup-dns

Writes /etc/resolver/<base-domain> (requires sudo).

setup-network

Create the shared Docker network.

mdocker setup-network

mdocker setup-network

Creates the multi-docker-edge Docker network.

setup-admin

A bundle of the admin-privileged phases (setup-tls + setup-dns), designed for the macOS app’s AppleScript admin escalation.

mdocker setup-admin

mdocker setup-admin

doctor

Read-only health check of the toolchain and state.

mdocker doctor

mdocker doctor

Checks the required tools, the mkcert CA, the resolver, the edge network and ports 80/443. See Running mdocker doctor.

Related

• First-Run Setup
• Concept: DNS & TLS