Skip to main content

Examples

Copy-pasteable snippets for the most common real-world mac workflows.

Onboard a New Agent​

mac env set MASTER_IP=10.1.5.7
mac pull agent
mac start agent

Switch to a Private Mirror​

mac env set MAC_REGISTRY=registry.internal.example.com/mac
mac pull all
mac restart all

Configure Switch SSH Credentials (Mixed Fleet)​

mac env set SWITCH_USER=admin SWITCH_PASSWD_LIST=admin,123455,YourThirdPassword
mac restart master

Back Up Prometheus Before mac clean​

docker run --rm \
    -v mac-prometheus-data:/data \
    -v $(pwd):/backup \
    alpine tar czf /backup/prometheus-backup-$(date +%Y%m%d).tgz /data
mac clean

Restore Prometheus​

docker volume create mac-prometheus-data
docker run --rm \
    -v mac-prometheus-data:/data \
    -v $(pwd):/backup \
    alpine tar xzf /backup/prometheus-backup-20260128.tgz -C /
mac start master

Pre-Set the Initial Admin Password​

mac env set MAC_ADMIN_PASSWORD='S3curity!'
mac start master      # picks up the value on first run only

Reset the Admin Password Later​

mac stop master
docker volume rm mac-api-data       # deletes users.json and JWT secret
mac env set MAC_ADMIN_PASSWORD='New-S3cur1ty!'
mac start master

Reload Agent After a Driver Upgrade​

sudo apt install -y --only-upgrade nvidia-driver-590
mac restart agent

The metrics-bridge on the master automatically picks the agent back up; no master-side restart needed.