I Replaced Homepage YAML with a SQLite UI — Here's Why

Description and use

Replacing YAML configuration with a SQLite UI for web dashboards eliminates formatting errors, removes restart requirements, and simplifies backup to a single file.

Problem

YAML configuration for dashboards like Homepage and Homarr is fragile; a single indentation error can break the entire dashboard, requiring file edits, restarts, and debugging.

Outcome

Switching from YAML to a SQLite‑based UI eliminates syntax errors, removes the need for restarts, simplifies backup to a single file, and provides a live, browser‑based control panel for homelab dashboards.

Workflow

• 1. Install AMUD on Proxmox using the provided one‑command script.
• 2. Access the AMUD web UI in a browser.
• 3. Use the UI to add, edit, or delete app cards, tabs, and settings such as appearance, integrations, and Proxmox token.
• 4. Save changes; they are written directly to the SQLite database in WAL mode.
• 5. To backup, copy /opt/amud/data/amud.db to a safe location.
• 6. To restore, replace the existing amud.db with the backup file and restart AMUD if necessary.

Evidence

Config lives in SQLite (amud.db), edited through the web UI

Source

Backup is one file: /opt/amud/data/amud.db

Source