Master & Dashboard
The master is up but the UI is broken or the API is unreachable.
Web dashboard returns 502 / 504
The web-ui (Nginx) container is up but cannot reach the api-server. Verify:
~$ curl http://localhost:28080/health
~$ docker logs mac-api-server | tail
If the API server is healthy, restart Nginx:
~$ docker compose -f /etc/mango/mac/docker-compose.master.yml restart web-ui
Login fails with "invalid credentials"
- Default credentials are
admin/admin. If you set a custom initial password viaMAC_ADMIN_PASSWORD, check that the variable was set before the first start — changing it later has no effect. - To reset the admin password, stop the master, delete the api-server data
volume (which holds
users.jsonand the JWT secret at/app/data/), then start again. Prometheus and Loki volumes are separate and survive this:~$ mac stop master~$ docker volume rm mac-api-data~$ mac env set MAC_ADMIN_PASSWORD=<new-password>~$ mac start master
"Connection refused" calling the API from outside the host
The dashboard works locally but a remote curl to :28080 fails.
- Check firewall:
sudo ufw status. - Confirm Docker is publishing the port:
docker ps | grep 28080should show0.0.0.0:28080->28080/tcp.
Health Endpoints
| Service | URL |
|---|---|
| API server | http://<master>:28080/health |
| Metrics-bridge | http://<master>:29199/health |
| Prometheus | http://<master>:29090/-/healthy |
| Loki | http://<master>:29210/ready |