tradmss/amud-dashboard repository overview

⁠AMUD Dashboard

AMUD (Advanced Modern Unified Dashboard) is a high-performance, intelligent homelab cockpit built for resource-constrained environments. While legacy dashboards demand heavy runtimes and YAML files, AMUD is a compiled Rust stack that idles around 30–50 MB RAM (server + agent) with sub-millisecond routing.

📚 Documentation: https://boubli.github.io/AMUD-Dashboard/⁠

Deploy: Docker guide⁠ · Deployment scripts⁠

docker pull tradmss/amud-dashboard:latest

⁠Quick start (Docker Compose)

services:
  amud_app:
    image: tradmss/amud-dashboard:latest
    ports:
      - "8000:8000"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

  amud_agent:
    image: tradmss/amud-dashboard:latest
    command: ["/app/amud-agent"]
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./run:/opt/amud/run
    environment:
      - AMUD_DOCKER=1
    restart: unless-stopped

Open http://<host>:8000 — default login is in the docs⁠.

⁠Proxmox telemetry (agent)

The agent talks to the Proxmox VE REST API directly. Set:

PVE_API_TOKEN=PVEAPIToken=root@pam!amud=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Create the token under Datacenter → Permissions → API Tokens. If unset, host CPU/RAM/disk metrics still work; LXC polling is skipped.

⁠Why AMUD vs Heimdall / Homepage / Homarr

⁠Support

Unraid first-boot error .amud-secrets-key: Permission denied → Troubleshooting⁠

• GitHub: boubli/AMUD-Dashboard⁠
• Docs: boubli.github.io/AMUD-Dashboard/docs⁠
• Sponsor: GitHub Sponsors⁠