First-Run Setup

Run this once after installation. A single command provisions everything the projects need to share.

one-time setup

mdocker setup

What mdocker setup does

setup runs four phases in order:

Phase	Script	Effect
Network	setup-network.sh	Creates the multi-docker-edge Docker network.
TLS	setup-tls.sh	Installs the mkcert CA and writes a wildcard cert for *.<base-domain>.
DNS	setup-dns.sh	Writes /etc/resolver/<base-domain> so the domain resolves to the local dnsmasq.
Edge	edge up	Boots Traefik, Mailcatcher, dnsmasq and the docker-socket-proxy.

sudo is requested once

Writing /etc/resolver/<base-domain> requires administrator rights, so setup prompts for your password once during the DNS phase. Nothing else needs sudo.

Verify it worked

1. Run the health check. doctor inspects the toolchain and the state (CA installed, resolver present, edge network, ports 80/443):

   mdocker doctor

   mdocker doctor

2. Confirm the edge stack is up:

   mdocker edge status

   mdocker edge status

3. Open the Mailcatcher UI to prove routing and TLS work end to end:

   mail UI

   open https://mail.coding9.test

Certificates survive updates

The certificate store lives under ~/.config/multi-docker/certs/ on purpose, so runtime updates never overwrite or delete it. Changing the base domain later with mdocker config set BASE_DOMAIN … regenerates the cert, resolver, overrides and edge stack automatically.

Next

You are ready to run something. Head to the Quickstart.