Installation

Installing MultiDocker is two things: make the mdocker command available on your PATH, and make sure the required tools are present. The actual infrastructure is created later by mdocker setup.

1. Install the required tools with Homebrew:

   brew install

   brew install mkcert nss yq jq

2. Put mdocker on your PATH. Pick either a symlink or a shell alias.

   Symlink

   symlink into /usr/local/bin

   ln -s "$PWD/bin/mdocker" /usr/local/bin/mdocker

   Shell alias

   Add this to ~/.zshrc, then restart your shell:

   ~/.zshrc

   alias mdocker="$HOME/multi-docker/bin/mdocker"

3. Verify the command resolves:

   mdocker

   mdocker --help

Prefer the app?

If you would rather use the graphical front-end, the macOS app ships its own runtime and does not need a symlink — see Installing & Runtime Model.

Next

With the command available, run the one-time First-Run Setup to create the certificates, DNS resolver and edge stack.