- Shell 46.7%
- Python 45.7%
- Jinja 7.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Kevin Heyer
2d35e19f65
Fabulous Dash publishes no release files, only an OCI image. The role takes the binary from the image layer that holds it (found through the build history) and verifies it by the layer digest of the manifest. Version via the new upstream type forgejo-release, pinned to 0.8.0. The first admin "admin" with the secret fabulous_dash_admin_password is written as store.json before the first start, which Fabulous Dash imports; the unit only starts once store.db or store.json exists, so the upstream default account admin/fabulous never exists (VM image). Optional setting fabulous_dash_external_url, sandboxed unit (1.3 OK). Tested: check-app.sh green (lint, template files, dev container twice, second run changed=1); login as admin with the password from settings.env; update from 0.7.1 to 0.8.0 in the dev container with a green smoke test; nothing left in /tmp or caches. VM image and boot test not run (CI after push). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
| .forgejo/workflows | ||
| .vibe | ||
| files | ||
| handlers | ||
| tasks | ||
| templates | ||
| tests | ||
| .clinerules | ||
| .cursorrules | ||
| .windsurfrules | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| GEMINI.md | ||
| iac.json | ||
| README.md | ||
iac-fabulous-dash
Fabulous Dash – die Startseite fürs Homelab mit Apps, Links, Kalender, Pastebin und Filebox – als LXC oder VM auf Proxmox VE, auf Debian 13. Teil von iac.
Installation (auf der Proxmox-Node)
bash -c "$(curl -fsSL https://iac.heyer.systems/fabulous-dash/ct.sh)" # LXC
bash -c "$(curl -fsSL https://iac.heyer.systems/fabulous-dash/vm.sh)" # VM
Ohne Dialog: IAC_NONINTERACTIVE=1 und var_*-Variablen – am einfachsten mit dem Generator auf
https://iac.heyer.systems/apps/fabulous-dash/.
Erster Login
http://<ip>:5661/ öffnen und als admin anmelden. Das Passwort wird pro Instanz erzeugt und
steht im Gast:
grep fabulous_dash_admin_password /etc/iac/settings.env
Das Startkonto admin/fabulous von Fabulous Dash gibt es hier nicht: iac legt den ersten Admin vor
dem ersten Start an, der Dienst startet erst danach. Name und Passwort lassen sich danach in der
Oberfläche ändern, iac fasst das Konto nie wieder an.
Ports
| Port | Zweck | Erreichbar |
|---|---|---|
| 5661/tcp | Weboberfläche und API | öffentlich (Firewall offen) |
Fabulous Dash spricht nur HTTP. Für den Betrieb im Internet einen Reverse-Proxy mit HTTPS davor stellen (z. B. iac-traefik) und unter Einstellungen → Sicherheit nur diesem Proxy vertrauen.
Einstellungen
Einstellung (/etc/iac/settings.env) |
Bedeutung |
|---|---|
fabulous_dash_external_url |
öffentliche Adresse, z. B. https://dash.example.org – nötig für Teilen-Links, Mails und Passkeys (Passkeys brauchen HTTPS) |
Weitere Umgebungsvariablen von Fabulous Dash (FD_SECRET, FD_OPENMETEO_URL, …) gehören in
/etc/fabulous-dash/local.env; iac fasst diese Datei nie an. Danach systemctl restart fabulous-dash.
Wo was liegt
| Pfad | Inhalt |
|---|---|
/usr/local/bin/fabulous-dash |
das Programm (eine Go-Binary mit eingebauter Oberfläche) |
/var/lib/fabulous-dash/db |
Datenbank store.db, Pastes, Filebox, Avatare, Backups (backups/) |
/var/lib/fabulous-dash/config |
Schlüssel für Sitzungen und gespeicherte Zugangsdaten, eigene CAs unter ca/ |
/etc/fabulous-dash/fabulous-dash.env |
Umgebung aus den Einstellungen (von iac verwaltet) |
/etc/fabulous-dash/local.env |
eigene Umgebungsvariablen |
Wichtig: config/ enthält den Schlüssel, mit dem Passwörter und Zugangsdaten verschlüsselt
sind – db/ und config/ immer zusammen sichern, oder das eingebaute Backup nutzen
(Einstellungen → Daten & Backup).
Herkunft und Updates
Upstream veröffentlicht keine Release-Dateien, nur ein Container-Image. iac nimmt die Binary aus
dem Image git.justdoit.network/releases/fabulous-dash:<version> (linux/amd64) und prüft die
Schicht über ihren sha256-Digest aus dem Image-Manifest – Docker läuft im Gast nicht.
Die Version ist in iac.json festgeschrieben und wird von Renovate angehoben, sobald die CI die
neue Version getestet hat. update im Gast installiert dann diese Version und startet den Dienst
neu; die Datenbank migriert Fabulous Dash beim Start selbst.
update
Die Docker-Anbindung (Live-Infos über /var/run/docker.sock) gibt es hier nicht – im Gast läuft
kein Docker. Ein Docker-Host lässt sich über einen Socket-Proxy (http://<host>:2375) anbinden.
Selbsttest (im Gast)
bash /var/lib/iac/src/core/bin/iac-smoke