Skip to main content

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 via MAC_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.json and 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 28080 should show 0.0.0.0:28080->28080/tcp.

Health Endpoints

ServiceURL
API serverhttp://<master>:28080/health
Metrics-bridgehttp://<master>:29199/health
Prometheushttp://<master>:29090/-/healthy
Lokihttp://<master>:29210/ready