Environment Variables

mac env shows, sets, and clears the variables that drive MAC's behavior — registry, master IP, switch credentials, and more.

mac env

~$ mac env                       # List managed variables and their sources
~$ mac env set KEY=VAL [...]     # Save to ~/.mac/env (per-user, persistent)
~$ mac env unset KEY [...]       # Remove from ~/.mac/env

File Priority

MAC reads variables from the following files, highest priority first:

1. ~/.mac/env — Per-user overrides (written by mac env set)
2. /etc/mango/mac/env — Global defaults (written by the installer; edit as root)

Any variable set in your shell environment when you call mac also takes precedence.

If your $HOME is shared across hosts (e.g. NFS-mounted), keep per-host values like NODE_NAME out of ~/.mac/env; put them in /etc/mango/mac/env instead.

Variable Reference

Common

Variable	Used by	Purpose
MASTER_IP	Agent	Master node IP (required; no default)
MAC_REGISTRY	All	Container image registry (public default repo.mangoboost.io/public-docker/mac)
MAC_CONFIG_DIR	All	Compose file directory (default /etc/mango/mac)
MAC_AUTH_ENABLED	Master	Enable JWT auth (default true)
MAC_ADMIN_PASSWORD	Master	Initial admin password on first start (default admin)
NODE_NAME	Agent	Override node name (default: hostname)
SDK_AGENT_IMAGE	Agent	mango-sdk-agent image (public default repo.mangoboost.io/public-docker/mango-sdk-agent:latest)
TZ	All	Container timezone, IANA name (auto-detected from the host if unset)

Service Ports

Variable	Used by	Purpose
MASTER_API_PORT	Master	API server published port (default 28080)
MASTER_WEB_PORT	Master	Web UI published port (default 23000)
PROMETHEUS_PORT	Master	Prometheus published port (default 29090)
LOKI_PORT	Master	Loki published port (default 29210)
SNMP_PORT	Master	switch-exporter SNMP port (default 161)
ALERT_RULES_PATH	Master	Override Prometheus alert-rules JSON file path

TLS (HTTPS)

Variable	Used by	Purpose
MAC_TLS_ENABLED	Master	Enable HTTPS for api-server and web-ui (default false)
MAC_TLS_CERT_DIR	Master	Host directory holding server.crt and server.key
MAC_TLS_PORT	Master	API server HTTPS port (default 28443)
MAC_WEB_TLS_PORT	Master	Web UI HTTPS port (default 23443)
MAC_TLS_CERT_FILE	Master	In-container path to TLS cert (default /etc/mac/certs/server.crt)
MAC_TLS_KEY_FILE	Master	In-container path to TLS key (default /etc/mac/certs/server.key)

Switch Access

Variable	Used by	Purpose
SWITCH_USER	Master	SSH username for switch CLI (default admin)
SWITCH_PASSWD_LIST	Master	Comma-separated SSH password list (tried in order)
SWITCH_PASSWD	Master	Legacy single SSH password (used only if _LIST unset)
SNMP_COMMUNITY	Master	Default SNMP community

LLMBoost

Variable	Used by	Purpose
LLMBOOST_API_ENDPOINT	Master	Override LLMBoost API endpoint (auto-discovered if unset)
LLMBOOST_K8S_API_URL	Master	Override K8s API URL
LLMBOOST_K8S_TOKEN	Master	K8s service-account token for full LLMBoost view
LLMBOOST_DASHBOARD_URL	Master	Override LLMBoost management UI URL

Inspecting Current State

Run mac env to print every managed variable with its current value and source (user for ~/.mac/env, global for /etc/mango/mac/env).