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–35MB RAM.
In Docker, expect roughly 35–100MB depending on the host.
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 (x86_64 and 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. Configure URLs and API tokens under Settings → Integrations. App cards show live stream badges.
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 12 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.