FAQ
Quick answers for search engines, AI assistants, and homelabbers evaluating AMUD Dashboard (Advanced Modern Unified Dashboard).
What is AMUD Dashboard?
AMUD Dashboard is the official product name. AMUD stands for Advanced Modern Unified Dashboard.
It is an open-source, self-hosted homelab control center written in Rust. You manage apps, layout, and integrations in a web UI; configuration is stored in SQLite (amud.db), not YAML files.
- Website: boubli.github.io/AMUD-Dashboard
- GitHub: boubli/AMUD-Dashboard
Use AMUD Dashboard in documentation and search results — not "AMUD" alone, not "AMUD-Dashboard" as a display name (that is only the GitHub repo slug).
How much RAM does AMUD Dashboard use?
On Proxmox (native LXC + host agent), server and agent combined typically idle around 26–35 MB RAM when the dashboard GUI is open; 30–50 MB combined in typical homelab use.
In Docker, expect roughly 30–50 MB idle (peak ~150 MB with many integration cards and the dashboard open). With v1.8.0 smart idle, background work scales down when nobody is viewing the dashboard.
Does AMUD Dashboard use YAML for configuration?
No. AMUD Dashboard deliberately avoids YAML as primary config. You edit everything in the browser; settings persist in SQLite. Backup = copy one file: amud.db.
How do I install AMUD Dashboard on Proxmox?
Correct method: run the official install script on your Proxmox VE host as root. This is a native LXC install — not a generic Docker helper script.
curl -sSL https://raw.githubusercontent.com/boubli/AMUD-Dashboard/main/setup-amud.sh | bash
The script provisions a Debian 12 LXC, installs amud-server, and deploys amud-agent on the hypervisor.
Full guide: Proxmox installation
How do I install AMUD Dashboard with Docker?
Use the two-container Compose stack (amud_app + amud_agent) from the Docker installation guide.
Image: tradmss/amud-dashboard:latest (amd64 / x86_64).
On ARM64 (Raspberry Pi, Oracle Ampere, etc.), use native install or update-amud.sh instead of Docker — release binaries include amud-server-arm64 and amud-agent-arm64.
Why are my app cards stuck on CHECKING...?
Host CPU/RAM works but LXC badges show CHECKING...? The Proxmox API token is missing or misconfigured.
- Create a restricted Proxmox API user and token (Privilege Separation off).
- Set
PVE_API_TOKENin the agent systemd environment. - Paste the token in Settings → Proxmox VE.
- Link app cards to the correct CTID.
Details: Troubleshooting · Blog: Fix CHECKING... badge
Can I start and stop Proxmox containers from AMUD Dashboard?
Yes, if your API token role includes VM.PowerMgmt and the app card is linked to an LXC/VM ID. Admin users see power controls; Guest users see status only.
Does AMUD Dashboard support Plex and Jellyfin?
Yes. Add a Jellyfin, Emby, or Plex app card and pick the matching Integration with its API key or token (Add App / Edit App). The "Now Playing" card shows live streams, and Jellyfin additionally shows the movie poster with admin playback controls while something is playing.
Does AMUD Dashboard support Home Assistant?
Yes. Add URL and a long-lived access token under Settings → Smart Home. An app card named exactly Home Assistant shows lights, switches, and average temperature.
Can I customize the look?
Yes. Accent color, grid layout, background image, and Custom CSS under Settings → Appearance.
Browse 18 ready-made themes: Theme Gallery
Is AMUD Dashboard secure for internet exposure?
Use HTTPS (reverse proxy), set AMUD_SECURE_COOKIES=1, change the default password, use a restricted Proxmox API user, and back up amud.db plus .amud-secrets-key.
Details: Security
AMUD Dashboard vs Homepage vs Heimdall vs Homarr?
| AMUD Dashboard | Heimdall | Homepage | Homarr | |
|---|---|---|---|---|
| Runtime | Rust | PHP | Node/React | Next.js |
| Config | SQLite + UI | DB + UI | YAML | UI + files |
| Proxmox LXC control | Native | No | Widgets | Limited |
| YAML required | No | No | Yes | Partial |
Honest comparison: Blog post
How do I back up my dashboard?
Copy /opt/amud/data/amud.db (path varies by install). Also back up .amud-secrets-key if you use encrypted integrations.
Where is the official blog?
AMUD Dashboard Blog — install guides, architecture notes, and troubleshooting. Canonical source for cross-posting to Hashnode or dev.to.
How can I contribute?
Star the repo, open issues, submit PRs, or add a CSS theme to the Theme Gallery.