Skip to main content

Installation

Install the MAC CLI and images on each host, then start services.

Prerequisites​

  • Ubuntu or RHEL-family amd64 with root access
  • Docker 20.10+ with Compose v2
  • NTP or chrony on every node, so tokens, logs and metrics share one clock
  • Access to MangoBoost's image registry or your mirror
  • GPU and MangoBoost drivers, which MAC does not install (Mango SDK documentation)

Install Docker​

On Ubuntu:

sudo apt update
sudo apt install docker.io docker-compose-v2
sudo systemctl enable --now docker
docker compose version

Run mac Without sudo​

sudo usermod -aG docker $USER
newgrp docker     # or log out and back in

sudo mac env set --global and master start/restart with a root-only token file still need sudo.

Get Repository Credentials​

Request APT guest credentials from contact@mangoboost.io. Images need no login.

Install the MAC Package​

1. Add the APT auth file​

sudo install -d -m 0755 /etc/apt/auth.conf.d
sudo tee /etc/apt/auth.conf.d/mango-sdk.conf >/dev/null <<EOF
machine repo.mangoboost.io
login   <guest-username>
password <guest-password>
EOF
sudo chmod 600 /etc/apt/auth.conf.d/mango-sdk.conf

2. Trust the repository signing key​

curl -fsSL \
    https://repo.mangoboost.io/artifactory/api/security/keypair/mb-gpg/public \
    | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/mango-sdk.gpg >/dev/null

3. Add the APT source​

echo "deb https://repo.mangoboost.io/artifactory/public-debian jammy universe" \
    | sudo tee /etc/apt/sources.list.d/mango-sdk.list

4. Install​

sudo apt update
sudo apt install mango-ai-center
mac --help

Without APT access, request a .deb and run sudo dpkg -i mango-ai-center_<version>_amd64.deb.

RHEL-Family Hosts​

Request the matching RPM from MangoBoost. Release packaging publishes RPMs for RHEL 9 and 10 to the internal repository; the public APT instructions above do not configure a YUM repository. Install Docker Engine with Compose v2 first; podman-docker cannot run MAC's Compose workflow.

sudo dnf install ./mango-ai-center-<version>.rpm
mac --help

For upgrades, use sudo dnf upgrade ./mango-ai-center-<version>.rpm. Removing the RPM keeps /etc/mango/mac, volumes, images and the node token. Complete cleanup is a separate destructive action.

Pull the Container Images​

mac images all
mac pull all                # or: mac pull master / mac pull agent

For your own registry, see Switch to a Private Mirror.

Offline Installation​

Request the offline bundle with its tarball and MANIFEST checksums. The bundle installs on Ubuntu 22.04 and 24.04. Hosts not listed in its bundle.env need Docker and Compose preinstalled. The bundle supports AMD GPU and GPU-less hosts. NVIDIA hosts must use online installation: dcgm-exporter is excluded from redistribution, and the offline installer refuses NVIDIA hosts even when the image was loaded separately.

  1. Verify and extract the bundle:

    sha256sum -c mango-ai-center-offline-<version>-ubuntu-amd64.tar.gz.sha256
    tar xzf mango-ai-center-offline-<version>-ubuntu-amd64.tar.gz
    cd mango-ai-center-offline-<version>-ubuntu-amd64

  2. Install the master first (--start all on a single server):

    sudo ./install.sh --start master --manifest-sha256 <published-MANIFEST-checksum>

  3. On each agent, pass the master's node token:

    sudo ./install.sh --start agent --master-ip <master-ip> \
        --env MAC_NODE_TOKEN=<master-token> --manifest-sha256 <published-MANIFEST-checksum>

    To keep the token out of process arguments, use --env-stdin instead.

Before updating an offline cluster, load the new bundle on every node:

mac load /opt/mango-ai-center-offline-<version>-ubuntu-amd64
mac images --check

SDK updates still need a reachable APT repository. For firmware without download URL access, use File upload.

Network and Firewall Ports​

Open these ports, or the ones you reconfigured:

From → ToPorts
User → MasterTCP 23000 (dashboard), 28080 (API); 23443, 28443 with TLS
Master → AgentTCP 28000, 29101, 29102, 29103, 29150, 29200, 29300, 29500
Agent → MasterTCP 28080 (logs and audit events, also with TLS); 28443 with TLS
Master → SwitchTCP 22 (SSH), 8080 (gNMI); UDP 161 (SNMP)
Master → BMCTCP 443 (Redfish)
Master → DPU SoCTCP 443, 8443 (Redfish)