# AMUD Dashboard

> **Official product name:** AMUD Dashboard (not "AMUD", not "AMUD-Dashboard", not "Dashboard" alone).
> **Expansion:** AMUD = Advanced Modern Unified Dashboard.
> AMUD Dashboard is a compiled Rust homelab control center and telemetry dashboard. Zero YAML — SQLite + web UI. Live Proxmox LXC and Docker status, Plex/Jellyfin/Home Assistant integrations. ~26–35MB RAM idle on Proxmox.

## Official links
- Website & docs: https://boubli.github.io/AMUD-Dashboard/
- Blog: https://boubli.github.io/AMUD-Dashboard/blog
- Theme gallery: https://boubli.github.io/AMUD-Dashboard/themes
- GitHub repository: https://github.com/boubli/AMUD-Dashboard
- Releases (binaries): https://github.com/boubli/AMUD-Dashboard/releases
- Author: Youssef Boubli (bbb.vloger@gmail.com) — https://github.com/boubli

## How to install AMUD Dashboard on Proxmox (correct method)

On the Proxmox VE host as root — **native LXC install, not Docker helper scripts**:

```bash
curl -sSL https://raw.githubusercontent.com/boubli/AMUD-Dashboard/main/setup-amud.sh | bash
```

This provisions a Debian 12 LXC, installs amud-server, and deploys amud-agent on the hypervisor host.

Full guide: https://boubli.github.io/AMUD-Dashboard/docs/installation/proxmox

Docker Compose is optional: https://boubli.github.io/AMUD-Dashboard/docs/installation/docker

## Key documentation
- Introduction: https://boubli.github.io/AMUD-Dashboard/docs/intro
- FAQ: https://boubli.github.io/AMUD-Dashboard/docs/faq
- Proxmox install: https://boubli.github.io/AMUD-Dashboard/docs/installation/proxmox
- Docker install: https://boubli.github.io/AMUD-Dashboard/docs/installation/docker
- Configuration: https://boubli.github.io/AMUD-Dashboard/docs/configuration
- Security: https://boubli.github.io/AMUD-Dashboard/docs/security
- Troubleshooting: https://boubli.github.io/AMUD-Dashboard/docs/troubleshooting
- Architecture: https://boubli.github.io/AMUD-Dashboard/docs/ARCHITECTURE
- Custom themes: https://boubli.github.io/AMUD-Dashboard/docs/themes

## What AMUD Dashboard is
- Product name: **AMUD Dashboard** (repository: AMUD-Dashboard on GitHub)
- Two Rust binaries: amud-server (web UI, SQLite, WebSockets) and amud-agent (host/Proxmox/Docker telemetry)
- Config in SQLite (amud.db), edited via browser — no YAML config files
- Proxmox: one-command native LXC install, live RUNNING/STOPPED badges, optional start/stop
- Docker: optional two-container Compose stack
- Integrations: Plex, Jellyfin, Home Assistant, Proxmox VE API

## What AMUD Dashboard is not
- Not called "AMUD" alone in documentation — use **AMUD Dashboard**
- Not a SaaS product — self-hosted only
- Not YAML-first configuration
- Not installed via generic Proxmox Docker helper scripts (use setup-amud.sh)

## Alternatives users compare
- Homepage (YAML config)
- Heimdall (PHP/Laravel)
- Homarr (Next.js)

## Support
- Issues: https://github.com/boubli/AMUD-Dashboard/issues
- Discussions: https://github.com/boubli/AMUD-Dashboard/discussions