Skip to main content

Service Control

pull, start, stop, and restart take a role: all, master, or agent.

mac pull​

Pull the role's images, including the GPU exporters this host needs.

mac pull all

mac images​

List the images the role needs and whether they are present.

mac images all --check
mac images prune           # remove unused MAC images after confirmation

mac load​

Load images from a complete offline bundle, even on agents. See Offline Installation.

mac load /opt/mango-ai-center-offline-<version>-ubuntu-amd64
mac load /opt/mango-ai-center-offline-<version>-ubuntu-amd64 --verify-only

mac start​

Start a role; all runs master and agent together. Agents need MASTER_IP and the master's token.

sudo mac start all
mac start agent --dry-run   # check settings without changing anything

start waits for running/healthy containers and, on the master, Prometheus and Loki readiness. --timeout accepts seconds or a duration (default 180 seconds). --no-wait returns after container creation and cannot be combined with --timeout. Starting or restarting master/all with the default root-only node-token file requires sudo; agent-only commands can use Docker-group access.

Missing images are pulled unless MAC_OFFLINE=true. After a reboot, mac start may restart Docker to clear stale Docker proxies, which affects other containers on the host.

mac stop​

Remove the role's containers; volumes and images are kept. Agents deregister unless you pass --keep-registration.

mac stop agent
mac stop agent --keep-registration

mac restart​

Recreate the role after configuration changes. Agents stay registered unless you pass --deregister.

sudo mac restart all

mac status​

List local MAC containers and their status. -v adds versions, role, master address and GPU details.

mac status -v

mac logs​

mac logs                   # last 50 lines from each container
mac logs api-server -n 200 # last 200 lines from one service
mac logs api-server -f     # follow

mac test​

Check a running cluster through the master. Run it on the master, with --master <ip>, or on an agent where mac env set saved MASTER_IP, per user or node-wide; a shell export is not read.

mac test -v                    # list every check
mac test --expect all          # also check that this node runs every service

Exit code 3 means this node passed and only other nodes failed.

mac version​

mac version

mac clean​

Delete MAC containers, data volumes (users, enrollment, alerts, metrics, logs) and local images after confirmation. --all also deletes mac-network, every MAC image and the Prometheus, Loki, GPU exporter and SDK agent images MAC uses, unless another container uses them.

mac clean
mac clean --all
warning

Cleaning destroys persistent data. To keep it, stop the role and run apt remove, not clean or apt purge, which also deletes the volumes.

mac llmboost detect​

Find local OpenAI-compatible model endpoints and suggest a LLMBOOST_HOST_PORTS value. Nothing is saved; review the results, as unrelated serving workloads may appear.

mac llmboost detect

mac user reset-password​

Recover an account on the master without a dashboard login. mac-api-server must be running. The command restarts api-server, signs the user out everywhere and can recreate admin; other data is kept.

sudo mac user reset-password admin