DEV Community

Youssef Boubli
Youssef Boubli

Posted on

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

AMUD Dashboard screenshot


BODY — copy from here ↓

Series: Building AMUD — Part 3 of 12
Part 1: Why I Built AMUD in Rust
Part 2: Install AMUD on Proxmox in One Command (No Docker Required)*

Homepage and Homarr are great — until you miss one YAML indent and the whole dashboard breaks. I built AMUD with a different rule: no YAML as primary config.

Quick facts

  • AMUD = Advanced Modern Unified Dashboard
  • Config lives in SQLite (amud.db), edited through the web UI
  • Layouts, tabs, apps, settings — all managed visually
  • Repo: https://github.com/boubli/AMUD-Dashboard

The YAML pain (you've felt it)

services:
  - Media:
      - Plex:
          href: http://plex.local:32400
           icon: plex.png
Enter fullscreen mode Exit fullscreen mode

One wrong space and the page is blank.

With Homepage/Homarr you often:

  • Edit files on disk or in Git
  • Restart or reload to see changes
  • Debug syntax errors in nested YAML
  • Keep config in sync across machines

What AMUD does instead

Everything goes into SQLite in WAL mode (fast concurrent reads/writes):

Setting Where
App cards and URLs UI — drag, edit, save
Category tabs UI
Grid columns, accent color Settings → Appearance
Integrations (Plex, Jellyfin, HA) Settings → Integrations
Proxmox token Settings → Proxmox VE

No file to SSH into. No restart after adding a bookmark.

Backup is one file

Your entire dashboard config:

/opt/amud/data/amud.db
Enter fullscreen mode Exit fullscreen mode

Copy that file = full backup. Restore it = full restore.

Docs: https://boubli.github.io/AMUD-Dashboard/docs/troubleshooting

When YAML dashboards still win

Be honest:

  • GitOps workflows — you want config in Git and PR reviews
  • Huge static service lists generated from Ansible/Terraform
  • Multi-environment configs from templates

AMUD is for homelabbers who want a living control panel you tweak from the browser — not a config repo.

AMUD's hard rule

From the roadmap — things AMUD will not do:

YAML as primary config. SQLite + UI is the whole point.

Try it

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

Next: Real-time telemetry without shell scripts.

⭐ Star the repo: https://github.com/boubli/AMUD-Dashboard

Top comments (0)