Install AMUD on Proxmox in One Command (No Docker Required)

Series: Building AMUD — Part 2 of 20
Previous: Part 1 — Why I Built AMUD in Pure Rust

Most homelab dashboards assume Docker. AMUD runs natively on Proxmox: a tiny LXC for the web server, an agent on the hypervisor host, and ~26–35MB RAM combined.

Quick facts

Stack	Rust, Axum, Tokio, SQLite
Config	Web UI only — no YAML
RAM	~26–35MB (server + agent)
Docs	https://boubli.github.io/AMUD-Dashboard/docs/installation/proxmox

Architecture

1. amud-agent (Proxmox host) — reads /proc, queries Proxmox API, writes to Unix socket

2. amud-server (Debian 12 LXC) — web UI on port 8000, SQLite config, WebSocket telemetry

One-command install

SSH to Proxmox as root:

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

The script:

• Installs amud-agent as systemd service on the host

• Creates LXC amud-dashboard (1 CPU, 256MB RAM, 4GB disk)

• Bind-mounts /opt/amud/run for IPC

• Prints the container IP when done

First login

http://<LXC-IP>:8000/

• Username: admin

• Password: password

Change immediately under Settings → Admin Profile.

Enable live LXC badges

Without a Proxmox API token, cards stay on CHECKING...

pveum role add AMUDAgentRole -privs "VM.Audit Sys.Audit VM.PowerMgmt"
pveum group add amud-group
pveum user add amud@pve -group amud-group
pveum aclmod / -group amud-group -role AMUDAgentRole
pveum user token add amud@pve amud-token --privsep 0

Paste token in Settings → Proxmox VE. Link app cards to CTIDs → RUNNING / STOPPED live.

⭐ https://github.com/boubli/AMUD-Dashboard