CLI Overview

The mac command-line tool is installed by the MAC Debian package at /usr/bin/mac. It is the supported way to start, stop, configure, and inspect MAC services on each host. The same binary is used on Master and Agent nodes — the role is selected at start time.

Tab completion is registered automatically; press <Tab> after mac to see all subcommands. Every command also accepts -h / --help for its own usage and flags (e.g. mac start --help).

Command Summary

Command	Purpose
mac pull	Pull container images from the configured registry
mac build	Build MAC images locally from a source checkout
mac start	Start MAC services in all, master, or agent mode
mac stop	Stop running MAC services
mac restart	Stop + start MAC services in one step
mac status	List all MAC containers (running and stopped)
mac logs	Tail logs for MAC containers
mac info	Print version, host details, config dir, GPU profile
mac test	Run operator tests (default: cluster-wide sanity check)
mac clean	Remove all MAC containers, networks, volumes, images
mac env	Show or modify MAC environment variables
mac version (-v, --version)	Print the CLI version and exit

mac pull, mac start, and mac restart accept --local / --registry flags to select between locally-built and published images — see Environment → MAC_IMAGE_SOURCE.

Where to Go

• Service Control — pull, build, start, stop, status, test, clean
• Environment Variables — mac env plus the full variable reference
• Examples — copy-pasteable snippets for common workflows
• Without the Package — running mac from a source checkout and direct docker compose use