🇬🇧 English  |  🇩🇪 Deutsch

SelfDashboard at a glance

_{A real homelab layout — every widget is a plugin, freely arrangeable and configurable.}

SelfDashboard is your personal control center for homelab and self-hosting: one Docker container, one browser tab — instead of a dozen open admin UIs.

Everything supports drag & drop, multiple dashboards (e.g. /dashboard/home, /dashboard/server), 6 themes, EN/DE — widgets come from the volume-only plugin system (install via Plugin Store or ZIP, update without rebuilding the image). See How SelfDashboard is built.

🇬🇧 English

Contents: What is it · How it's built · What's new (v2.0.0) · Plugins · Quick Start · Docker & Unraid · Login & users · Kiosk · Env vars · Troubleshooting

What is SelfDashboard?

See the overview above for a full screenshot walkthrough.

SelfDashboard is a clean, modular, self-hosted home dashboard with a powerful plugin system — running as a single Docker container. Manage multiple dashboards, customize every detail, and add widgets for your self-hosted services.

Plugins are not bundled in the image. You install them from the Plugin Store (GitHub) or ZIP into a mounted folder (/app/plugins/custom). The Docker image only ships the core app (UI, store, shared APIs). Details: docs/PLUGINS.md · docs/PLUGIN_DEV.md.

How it compares

Heimdall, Homarr, Dashy and Homepage are all great projects — SelfDashboard just focuses on something different: live widgets with real backends, built-in auth, and a kiosk mode, all configured in the UI.

A good fit if you want

• Live, interactive widgets (Docker control, FRITZ!Box, CrowdSec, calendar, mail) — not just links
• Multi-user with real auth / 2FA and a wall-tablet kiosk
• To configure everything in the UI instead of editing config files

Maybe not for you if

• You just want a simple bookmark/start page (Heimdall or Homepage are lighter for that)
• You can't run a Docker container, or prefer a purely static config-file workflow
• You need a large, established plugin ecosystem today — SelfDashboard's is younger and still growing

Note: plugin server code runs with the app's privileges (no sandbox yet) — only install plugins you trust.

How SelfDashboard is built

flowchart TB
  subgraph image["Docker image (core)"]
    UI["Next.js UI · Plugin Store · dashboards"]
    CORE["Built-in APIs: calendar, mail, docker, crowdsec, fritzbox, weather, …"]
    GW["Gateway /api/plugins/{id}/…"]
  end
  subgraph vol["Volume /app/plugins/custom"]
    W["per plugin: plugin.json + widget.js (+ server.mjs for some)"]
  end
  subgraph gh["GitHub branch e.g. main"]
    IDX["plugins-pack/plugins-index.json"]
    PACK["plugins-pack/{id}/widget.js (+ server.mjs)"]
  end
  gh -->|"Store: Install / Update"| vol
  vol -->|"browser loads widget.js"| UI
  W --> GW
  CORE --> UI

App update vs plugin update

What's new — v2.0.0

Security & hardening (Docker image)

• Non-root container (PUID/PGID) — runs as a configurable unprivileged user (Unraid default 99/100); the entrypoint fixes volume ownership on start. Match CrowdSec's PUID/PGID to read crowdsec.db directly.
• Encrypted credentials everywhere — calendar, mail and widget passwords/tokens (AdGuard, Pi-hole, FRITZ!, Speedtest, …) are sealed with AES-256-GCM; the browser only sees ciphertext. Set a fixed SELFDASHBOARD_SECRET_KEY so they survive updates.
• SSRF protection in every proxy plugin (DNS-resolved, blocks loopback / link-local / cloud-metadata); TOTP replay protection; reproducible npm ci build + container HEALTHCHECK.

New plugins

• Philips Hue (Beta) — control lights & rooms in the Hue-app style: per-room toggle, brightness slider, real light colour, colour picker.
• Homematic / RaspberryMatic (Beta) — heating thermostats (target temp + Auto/Manual/Boost), switches, dimmers (on/off + colour), window contacts, sensors, system variables and programs; auto-grouped by CCU room (drag-and-drop sortable, multi-column), devices renamable. JSON-RPC login, no add-on required.
• FRITZ! Smart Home (Beta) — FRITZ!DECT thermostats (target temp), smart plugs (on/off + watt), window contacts and sensors via the AHA-HTTP interface; PBKDF2 SID login.
• Bambu Lab Camera (Beta) — live camera image from Bambu Lab printers: P1/A1 directly (local, port 6000) or any MJPEG/snapshot URL (e.g. X1 via go2rtc); auto-refreshing, access code stored encrypted, LAN-only addresses.
• Jellyfin — active sessions (own widget) · Selfstream · Emby · Jellyfin — combined stream list with a configurable title.
• 8 new integrations (Beta): Plex, Proxmox VE, TrueNAS, Home Assistant, OPNsense, UniFi Controller, Nginx Proxy Manager, OpenMediaVault, plus Speedtest Tracker.
• Auto-index store — drop a plugin folder into plugins-pack/<id>/ and push; plugins-index.json regenerates automatically (no manual index editing).

CrowdSec 1.5.x

• Attack world map (real GeoIP dots, point/arc view) · separate local bans vs. community (CAPI) bans counts · optional alert list beside the map.

Full API/plugin notes: docs/CHANGELOG.md.

Documentation

Features

Recent plugin and API changes are summarized in docs/CHANGELOG.md.

Plugins

Widgets are not bundled in the image — install them from the Plugin Store or upload a ZIP. Each plugin has its own README (EN/DE) under plugins-pack/<id>/.

Install & folders: docs/PLUGINS.md · Develop plugins: docs/PLUGIN_DEV.md

Plugins marked (Beta) are new integrations that have not yet been tested against every server version — feedback (with the service version) is welcome.

	Plugin	Category	Description
	AdGuard Home	Network	DNS stats, protection toggle
	Apple Music	Media	In-browser player (Beta)
🔖	Bookmarks	Utility	Quick links with groups
📅	Calendar	Productivity	CalDAV + ICS
🕐	Clock	Utility	Time, date, timezone
	CrowdSec	Security	Alerts, bans, world map (optional)
	Docker	System	Containers via socket
	Emby	Media	Active sessions
📈	FRITZ! WAN	Network	Throughput chart
⚡	FRITZ! Energy	Network	Smart plug kWh
	FRITZ! Smart Home	Utility	Thermostats, plugs, contacts (AHA) (Beta)
	Google Home / Nest	Utility	Nest thermostats, sensors, device status (SDM API) (Beta)
	Home Assistant	Utility	Selected entities (Beta)
	Homematic	Utility	Heating, switches, sensors, rooms (RaspberryMatic) (Beta)
	Bambu Lab Camera	Utility	Live printer camera (P1/A1 local or stream URL) (Beta)
🖼️	Iframe	Utility	Embed URLs
	Jellyfin	Media	Active sessions
✉️	Email	Productivity	Navbar IMAP badge
	Nginx Proxy Manager	Network	Proxy hosts overview (Beta)
	OpenMediaVault	Storage	System info via RPC (Beta)
	OPNsense	Network	Version, gateways (Beta)
📦	Parcel Tracking	Utility	DHL / Hermes / DPD tracking, no API key
	Philips Hue	Utility	Lights & rooms control (Beta)
	Pi-hole	Network	Pi-hole v6 stats
	Plex	Media	Active sessions (Beta)
	Proxmox VE	System	Nodes, VMs/LXC (Beta)
	Reolink Camera	Utility	Live camera, AI/motion badges, PTZ (Beta)
📝	Scratchpad	Utility	Short notes
✉️	SelfMailer	Productivity	Unread across all SelfMailer mailboxes
📺	Selfstream	Media	Live IPTV
📺	Selfstream · Emby · Jellyfin	Media	Combined stream list
	Spotify	Media	Now playing, controls, seek, volume, search & device picker
	Speedtest Tracker	Network	Latest down/up/ping (Beta)
	TrueNAS	Storage	System + pool status (Beta)
	UniFi Controller	Network	WLAN/LAN/WAN status (Beta)
	Unraid	System	Unraid 7.2+ GraphQL overview
	Unraid Docker	System	Containers via Unraid API
	Uptime Kuma	Network	Status-page monitors
🌤️	Weather	Utility	Open-Meteo (proxy), day blocks + 7-day
	WireGuard	Network	wg-easy peers — who's online now + handshake history & transfer (Beta)
🔀	Zoraxy	Network	Reverse-proxy host overview (Beta)

_{All plugin READMEs are bilingual (EN/DE). Brand logos via homarr-labs/dashboard-icons.}

Quick Start

Required: map /app/data and /app/plugins/custom. Without the plugins folder, the store can install files but they will not persist.

Image tags: Unraid template uses ghcr.io/kabelsalatundklartext/selfdashboard:latest. The plugin catalog is loaded from GitHub branch main (SELFDASHBOARD_PLUGINS_GITHUB_REF, normally left as-is).

Non-root container (PUID/PGID): the app runs non-root, by default as PUID/PGID 99/100 (Unraid nobody:users). On start, the entrypoint remaps to your PUID/PGID and chowns /app/data + /app/plugins/custom automatically (opt-out: SELFDASHBOARD_SKIP_CHOWN=1). CrowdSec tip: set PUID/PGID to the same values as your CrowdSec container — then SelfDashboard owns and reads crowdsec.db directly, surviving nightly backups that restart CrowdSec (no chmod needed).

Option 1 — Unraid Community Apps (recommended)

1. Open Community Apps → search for SelfDashboard
2. Install — set Config Storage, Plugins Storage, port (default 3000)
3. Open http://YOUR-IP:3000
4. Plugin Store → From GitHub — install widgets you need (Calendar, Bookmarks, …)
5. Click + to place widgets on the dashboard → Ctrl+F5 if a widget stays blank
6. Done ✓

Option 2 — Docker run

docker run -d \
  --name selfdashboard \
  --restart unless-stopped \
  -p 3000:3000 \
  -e TZ=Europe/Berlin \
  -v /mnt/user/appdata/selfdashboard:/app/data \
  -v /mnt/user/appdata/selfdashboard/plugins:/app/plugins/custom \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/kabelsalatundklartext/selfdashboard:latest

(**/app/data* → dashboard.json, calendar, logs. /app/plugins/custom → installed plugins. Store → From GitHub or ZIP, then Ctrl+F5. Docker socket optional — Docker plugin only. CrowdSec mount optional — CrowdSec plugin only.)*

Option 3 — docker-compose

git clone https://github.com/kabelsalatundklartext/selfdashboard.git
cd selfdashboard
docker-compose up -d

Docker & Unraid template

Unraid: unraid/selfdashboard.xml on branch main — Config Storage, Plugins Storage (both required for a normal setup).

After a plugin update: Store → Update → Ctrl+F5. After an app update: pull new image, restart — layouts and installed plugins stay on the volumes.

Login & multi-user

SelfDashboard requires login. On first start (no users yet) you are redirected to /setup to create the admin account. Existing dashboard.json in appdata is migrated to that admin automatically (backup: dashboard.json.pre-auth-migrated).

Admin locked out (forgot password)

There is no email reset (would need SMTP — not typical for homelab). Simplest: env reset on Unraid:

1. Env password reset (recommended on Unraid) — edit container, add variable:

   • SELFDASHBOARD_AUTH_RESET_PASSWORD = your new password (min. 8 chars)
   • optional: SELFDASHBOARD_AUTH_RESET_USER=admin (default: first admin)
   • or one field: SELFDASHBOARD_AUTH_RESET=admin:NewPassword
   • Restart container → sign in → clear the variable(s) → restart again

2. Direct CLI (shell access):

   docker exec selfdashboard node /app/scripts/auth-reset-password.mjs --username admin --password 'NewSecurePass'
   

3. Second admin — reset password under Settings → Users.

Dashboard Management

Each dashboard gets its own URL. Navigate between dashboards via the tab bar in the navbar or through Settings → Dashboards.

Widget Controls

In Edit Mode (✏️ button), hover over any widget to see controls:

Responsive layout (phone, tablet & desktop)

The dashboard uses three layout bands based on the dashboard grid width (the track that holds the widgets — not only the outer browser window):

How to tune it: enter Edit mode (✏️), open a widget’s ⚙️ settings. Below the plugin-specific options, “Layout: phone & tablet” lets you set optional phone row height / min height and tablet position & size. Leave fields empty to keep using the desktop layout values for that band.

On narrow viewports (about ≤ 1024 px) the navbar web search moves to a second row at full width so it is not squeezed into the corner next to zoom and actions.

Plugins can optionally read the layoutMode prop ('phone' \| 'tablet' \| 'desktop') for their own responsive UI — see docs/PLUGIN_DEV.md.

Kiosk mode (wall tablet)

Public view-only display for a wall-mounted tablet or guest browser — separate from the normal logged-in dashboard.

Ideal for a kitchen display, wall tablet, or shared screen on your LAN.

Settings Overview

General — Language (DE/EN), dashboard title, navbar web search, navbar mail badge, navbar display style, dashboard tab visibility

Users — Change password, 2FA (TOTP), kiosk / wall tablet (admin). Admins also manage users and plugin whitelist here.

Dashboards — Create, edit, delete dashboards. Toggle tab visibility per dashboard. Set emoji or custom PNG icon.

Design — Navbar display style; grid spacing; navbar background (JPG/PNG + overlay); dashboard background (off / 1 image / 2 images side by side + overlay); logo upload; color theme; custom color overrides

Email — IMAP accounts, navbar badge, poll interval, connection test

Logs (Protokoll) — Central error log for support and debugging: filter by level, source, plugin; download .txt / JSONL; retention 3 / 7 / 30 days. Every plugin registered via registerPlugin logs render failures and failed /api/* calls automatically. Mail uses the same log with plugin id mail. Details: docs/LOGGING.md.

Environment Variables

Security notes

SelfDashboard is built for a trusted home LAN. A security review (2026-06) hardened the auth and plugin surfaces; the points below matter if you expose the app beyond your LAN.

Hardened in code:

• Login brute-force: failed attempts are now counted persistently per account in SQLite (10 / 15 min → temporary lockout). This survives restarts and is independent of the client IP, so spoofing X-Forwarded-For no longer bypasses it.
• Spoofable proxy headers are ignored unless SELFDASHBOARD_TRUST_PROXY=1 (set this only behind a real reverse proxy).
• Admin actions require completed MFA: user/role/plugin-grant management is blocked for sessions that have not passed the second factor.
• Rate limits added to change password and disable TOTP.
• TOTP secrets are encrypted at rest (AES-256-GCM via SELFDASHBOARD_SECRET_KEY), so a leaked auth.db alone cannot mint valid 2FA codes. Existing enrollments are upgraded transparently.
• Docker container actions (start/stop/restart) now require an admin with completed MFA — read-only listing stays available to widget users.
• Plugin pack extraction validates every zip entry against path traversal (zip-slip) and enforces entry-count limits; uploads have a hard entry cap.
• Plugin SVG assets are served with Content-Disposition: attachment, X-Content-Type-Options: nosniff and a locked-down CSP, preventing stored XSS via uploaded SVGs.

Operator responsibilities / when exposing publicly:

• Use HTTPS and set SELFDASHBOARD_SECURE_COOKIES=1. The default is off so plain-HTTP LAN setups keep working — but over the internet, session cookies must be Secure.
• Plugin code runs with full server privileges. Uploaded/remote plugin server.mjs files execute in the Node process — there is no sandbox. Only install plugins you trust, and treat the admin account as equivalent to shell access.
• TLS verification for IMAP/FRITZ! can be disabled per connection — leave it on unless you have a specific reason.
• Use a strong admin password and a fixed SELFDASHBOARD_SECRET_KEY.

Known lower-priority follow-ups (not yet changed): the credential-encryption KDF uses a static salt, and CalDAV lacks DNS-rebinding protection (IMAP/FRITZ! already resolve and check the target IP). These are low risk on a trusted LAN.

Troubleshooting

Technology

• Frontend: Next.js 15, React 18, Tailwind CSS
• State: Zustand — persisted to localStorage (cache) and to dashboard.json on the server when /app/data (or SELFDASHBOARD_DATA_DIR) is available
• Grid: react-grid-layout
• Container: Node.js 22 Alpine (multi-stage build, Next.js standalone)
• Plugins: Volume-only — dynamic widget.js load + pluginRegistry; catalog from GitHub plugins-pack/
• Develop: npm run dev in repo root; publish plugins with npm run publish:plugin-pack

License

MIT — free to use, modify and share.

🇩🇪 Deutsch

Inhalt: Was ist das · Aufbau · Neu (v2.0.0) · Plugins · Schnellstart · Docker & Unraid · Login · Kiosk · Umgebungsvariablen · Troubleshooting

SelfDashboard im Überblick

_{Ein reales Homelab-Layout — alle Widgets sind Plugins, frei anordbar und konfigurierbar.}

SelfDashboard ist dein persönliches Kontrollzentrum für Homelab und Self-Hosting: ein Docker-Container, ein Browser-Tab — statt zwölf geöffneter Admin-Oberflächen.

Alles ist Drag & Drop, mehrere Dashboards (z. B. /dashboard/home, /dashboard/server), 6 Themes, DE/EN — Widgets kommen aus dem Volume-only Plugin-System (Store oder ZIP, Updates ohne Image-Rebuild). Siehe Aufbau von SelfDashboard.

Was ist SelfDashboard?

SelfDashboard ist ein sauberes, modulares, selbst gehostetes Home-Dashboard mit einem leistungsstarken Plugin-System — als einzelner Docker-Container. Verwalte mehrere Dashboards, passe jedes Detail an und füge Widgets für deine selbst gehosteten Dienste hinzu.

Plugins stecken nicht im Image. Installation über Plugin-Store (GitHub) oder ZIP nach /app/plugins/custom. Das Image enthält nur die Kern-App (UI, Store, gemeinsame APIs). Details: docs/PLUGINS.md · docs/PLUGIN_DEV.md.

Vergleich

Heimdall, Homarr, Dashy und Homepage sind alle super Projekte — SelfDashboard setzt einfach auf einen anderen Schwerpunkt: Live-Widgets mit echtem Backend, eingebaute Auth und einen Kiosk-Modus, alles in der UI konfiguriert.

Passt gut, wenn du willst

• Live-Widgets, die wirklich was tun (Docker-Steuerung, FritzBox, CrowdSec, Kalender, Mail) — nicht nur Links
• Mehrbenutzer mit echter Auth / 2FA und einen Kiosk fürs Wand-Tablet
• Alles in der UI konfigurieren statt Config-Dateien zu editieren

Vielleicht nichts für dich, wenn

• Du nur eine einfache Lesezeichen-/Startseite willst (dafür sind Heimdall oder Homepage schlanker)
• Du keinen Docker-Container betreiben kannst oder einen rein statischen Config-Datei-Workflow bevorzugst
• Du heute ein großes, etabliertes Plugin-Ökosystem brauchst — das von SelfDashboard ist jünger und wächst noch

Hinweis: Plugin-Server-Code läuft mit den Rechten der App (noch keine Sandbox) — installier nur Plugins, denen du vertraust.

Aufbau von SelfDashboard

flowchart TB
  subgraph image["Docker-Image (Kern)"]
    UI["Next.js UI · Plugin-Store · Dashboards"]
    CORE["Eingebaute APIs: Kalender, Mail, Docker, CrowdSec, FRITZ!, Wetter, …"]
    GW["Gateway /api/plugins/{id}/…"]
  end
  subgraph vol["Volume /app/plugins/custom"]
    W["pro Plugin: plugin.json + widget.js (+ optional server.js)"]
  end
  subgraph gh["GitHub z. B. Branch main"]
    IDX["plugins-pack/plugins-index.json"]
    PACK["plugins-pack/{id}/widget.js (+ server.mjs)"]
  end
  gh -->|"Store: Installieren / Aktualisieren"| vol
  vol -->|"Browser lädt widget.js"| UI
  W --> GW
  CORE --> UI

App-Update vs Plugin-Update

Neu — v2.0.0

Sicherheit & Härtung (Docker-Image)

• Non-root-Container (PUID/PGID) — läuft als einstellbarer unprivilegierter User (Unraid-Standard 99/100); der Entrypoint korrigiert die Volume-Rechte beim Start. PUID/PGID wie bei CrowdSec setzen, um crowdsec.db direkt zu lesen.
• Verschlüsselte Zugangsdaten überall — Kalender-, Mail- und Widget-Passwörter/-Tokens (AdGuard, Pi-hole, FRITZ!, Speedtest, …) werden mit AES-256-GCM versiegelt; der Browser sieht nur Ciphertext. Festen SELFDASHBOARD_SECRET_KEY setzen, damit sie Updates überleben.
• SSRF-Schutz in jedem Proxy-Plugin (DNS-aufgelöst, blockt Loopback / Link-Local / Cloud-Metadata); TOTP-Replay-Schutz; reproduzierbarer npm ci-Build + Container-HEALTHCHECK.

Neue Plugins

• Philips Hue (Beta) — Lampen & Räume im Hue-App-Stil steuern: Toggle pro Raum, Helligkeits-Slider, echte Lichtfarbe, Farbwähler.
• Homematic / RaspberryMatic (Beta) — Heizungsthermostate (Soll-Temp + Auto/Manuell/Boost), Schalter, Dimmer (an/aus + Farbe), Fensterkontakte, Sensoren, Systemvariablen und Programme; automatisch nach CCU-Raum gruppiert (per Drag-and-Drop sortierbar, mehrspaltig), Geräte umbenennbar. JSON-RPC-Login, kein Addon nötig.
• FRITZ! Smart Home (Beta) — FRITZ!DECT-Thermostate (Soll-Temp), Steckdosen (an/aus + Watt), Fensterkontakte und Sensoren über das AHA-HTTP-Interface; PBKDF2-SID-Login.
• Bambu Lab Kamera (Beta) — Live-Kamerabild von Bambu-Lab-Druckern: P1/A1 direkt (lokal, Port 6000) oder beliebige MJPEG-/Snapshot-URL (z. B. X1 via go2rtc); aktualisiert sich automatisch, Zugangscode verschlüsselt, nur LAN-Adressen.
• Jellyfin — aktive Sessions (eigenes Widget) · Selfstream · Emby · Jellyfin — kombinierte Stream-Liste mit einstellbarem Titel.
• 8 neue Integrationen (Beta): Plex, Proxmox VE, TrueNAS, Home Assistant, OPNsense, UniFi Controller, Nginx Proxy Manager, OpenMediaVault, dazu Speedtest Tracker.
• Auto-Index-Store — Plugin-Ordner nach plugins-pack/<id>/ legen und pushen; plugins-index.json wird automatisch neu generiert (kein Hand-Editieren des Index).

CrowdSec 1.5.x

• Angriffs-Weltkarte (echte GeoIP-Punkte, Punkt-/Bogen-Ansicht) · getrennte Zähler für lokale Banns und Community-Banns (CAPI) · optionale Alert-Liste neben der Karte.

API-/Plugin-Details: docs/CHANGELOG.md.

Dokumentation

Features

Aktuelle Plugin- und API-Änderungen: docs/CHANGELOG.md.

Plugins

Widgets kommen nicht im Image mit — Installation über Plugin-Store oder ZIP. Pro Plugin eine eigene README (DE/EN) unter plugins-pack/<id>/.

Installation & Ordner: docs/PLUGINS.md · Entwicklung: docs/PLUGIN_DEV.md

Mit (Beta) markierte Plugins sind neue Integrationen, die noch nicht gegen jede Server-Version getestet sind — Feedback (mit Versionsangabe) ist willkommen.

	Plugin	Kategorie	Kurzbeschreibung
	AdGuard Home	Netzwerk	DNS-Statistik, Schutz umschalten
	Apple Music	Media	Player im Browser (Beta)
🔖	Bookmarks	Utility	Schnelllinks mit Gruppen
📅	Kalender	Productivity	CalDAV + ICS
🕐	Uhr	Utility	Zeit, Datum, Zeitzone
	CrowdSec	Sicherheit	Alerts, Banns, Weltkarte (optional)
	Docker	System	Container per Socket
	Emby	Media	Aktive Sessions
📈	FRITZ! Internet	Netzwerk	WAN-Durchsatz-Kurve
⚡	FRITZ! Energie	Netzwerk	Steckdose kWh/W
	FRITZ! Smart Home	Utility	Thermostate, Steckdosen, Kontakte (AHA) (Beta)
	Google Home / Nest	Utility	Nest-Thermostate, Sensoren, Gerätestatus (SDM-API) (Beta)
	Home Assistant	Utility	Ausgewählte Entitäten (Beta)
	Homematic	Utility	Heizung, Schalter, Sensoren, Räume (RaspberryMatic) (Beta)
	Bambu Lab Kamera	Utility	Live-Druckerkamera (P1/A1 lokal oder Stream-URL) (Beta)
🖼️	Iframe	Utility	Webseite einbetten
	Jellyfin	Media	Aktive Sessions
✉️	E-Mail	Productivity	Navbar IMAP-Badge
	Nginx Proxy Manager	Netzwerk	Proxy-Hosts-Übersicht (Beta)
	OpenMediaVault	Storage	Systeminfo per RPC (Beta)
	OPNsense	Netzwerk	Version, Gateways (Beta)
📦	Paketverfolgung	Utility	Sendungsverfolgung DHL / Hermes / DPD, ohne API-Key
	Philips Hue	Utility	Lampen & Räume steuern (Beta)
	Pi-hole	Netzwerk	DNS-Statistik v6
	Plex	Media	Aktive Sessions (Beta)
	Proxmox VE	System	Nodes, VMs/LXC (Beta)
	Reolink Kamera	Utility	Live-Kamera, KI-/Bewegungs-Badges, PTZ (Beta)
📝	Notizzettel	Utility	Kurznotizen
✉️	SelfMailer	Productivity	Ungelesene über alle SelfMailer-Postfächer
📺	Selfstream	Media	IPTV-Streams live
📺	Selfstream · Emby · Jellyfin	Media	Kombinierte Stream-Liste
	Spotify	Media	Aktueller Titel, Steuerung, Seek, Lautstärke, Suche & Gerätewahl
	Speedtest Tracker	Netzwerk	Letzter Down/Up/Ping (Beta)
	TrueNAS	Storage	System + Pool-Status (Beta)
	UniFi Controller	Netzwerk	WLAN/LAN/WAN-Status (Beta)
	Unraid	System	Unraid 7.2+ GraphQL-Übersicht
	Unraid Docker	System	Container per Unraid-API
	Uptime Kuma	Netzwerk	Status-Page-Monitore
🌤️	Wetter	Utility	Open-Meteo (Proxy), Tagesabschnitte + 7 Tage
	WireGuard	Netzwerk	wg-easy-Peers — wer jetzt online ist + Handshake-Verlauf & Transfer (Beta)
🔀	Zoraxy	Netzwerk	Reverse-Proxy-Host-Übersicht (Beta)

_{Alle Plugin-READMEs sind zweisprachig (DE/EN). Marken-Logos via homarr-labs/dashboard-icons.}

Schnellstart

Pflicht: /app/data und /app/plugins/custom mounten. Ohne Plugin-Ordner gehen Store-Installationen beim Neustart verloren.

Image-Tags: Unraid-Template nutzt ghcr.io/kabelsalatundklartext/selfdashboard:latest. Der Plugin-Katalog kommt vom GitHub-Branch main (SELFDASHBOARD_PLUGINS_GITHUB_REF, normalerweise unverändert lassen).

Non-root-Container (PUID/PGID): Die App läuft non-root, standardmäßig als PUID/PGID 99/100 (Unraid nobody:users). Der Entrypoint mappt beim Start auf deine PUID/PGID und chownt /app/data + /app/plugins/custom automatisch (Opt-out: SELFDASHBOARD_SKIP_CHOWN=1). CrowdSec-Tipp: PUID/PGID auf dieselben Werte wie dein CrowdSec-Container setzen — dann besitzt und liest SelfDashboard die crowdsec.db direkt, auch nach nächtlichen Backups, die CrowdSec neu starten (kein chmod nötig).

Option 1 — Unraid Community Apps (empfohlen)

1. Community Apps → SelfDashboard suchen
2. Installieren — Config Storage, Plugins Storage, Port (Standard 3000)
3. http://DEINE-IP:3000 öffnen
4. Plugin-Store → Von GitHub — benötigte Widgets installieren (Kalender, Lesezeichen, …)
5. + — Widgets aufs Dashboard legen → Strg+F5, falls ein Widget leer bleibt
6. Fertig ✓

Option 2 — Docker run

docker run -d \
  --name selfdashboard \
  --restart unless-stopped \
  -p 3000:3000 \
  -e TZ=Europe/Berlin \
  -v /mnt/user/appdata/selfdashboard:/app/data \
  -v /mnt/user/appdata/selfdashboard/plugins:/app/plugins/custom \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/kabelsalatundklartext/selfdashboard:latest

(**/app/data* → dashboard.json, Kalender, Protokoll. /app/plugins/custom → installierte Plugins. Store → Von GitHub oder ZIP, dann Strg+F5. Docker-Socket optional — Docker-Plugin. CrowdSec-Mount optional — CrowdSec-Plugin.)*

Option 3 — docker-compose

git clone https://github.com/kabelsalatundklartext/selfdashboard.git
cd selfdashboard
docker-compose up -d

Docker & Unraid-Template

Unraid: unraid/selfdashboard.xml auf Branch main — Config Storage und Plugins Storage (für den Normalbetrieb beide nötig).

Nach Plugin-Update: Store → Aktualisieren → Strg+F5. Nach App-Update: neues Image pullen, neu starten — Layout und installierte Plugins bleiben auf den Volumes.

Login & Mehrbenutzer

Ein Login ist nötig. Beim ersten Start (noch kein Benutzer) → /setup (Admin anlegen). Bestehendes dashboard.json im Appdata wird diesem Admin zugeordnet (Backup: dashboard.json.pre-auth-migrated).

Admin ausgesperrt (Passwort vergessen)

Kein E-Mail-Reset (bräuchte SMTP — im Homelab unüblich). Am einfachsten auf Unraid: Env-Reset

1. Passwort per Env (empfohlen) — Container bearbeiten, Variable setzen:

   • SELFDASHBOARD_AUTH_RESET_PASSWORD = neues Passwort (min. 8 Zeichen)
   • optional: SELFDASHBOARD_AUTH_RESET_USER=admin (Standard: erster Admin)
   • oder kombiniert: SELFDASHBOARD_AUTH_RESET=admin:NeuesPasswort
   • Container neu starten → einloggen → Variable leeren → erneut starten

2. CLI (Shell):

   docker exec selfdashboard node /app/scripts/auth-reset-password.mjs --username admin --password 'NeuesPasswort'
   

3. Zweiter Admin — Einstellungen → Benutzer → Passwort zurücksetzen.

Dashboard-Verwaltung

Jedes Dashboard hat eine eigene URL. Zwischen Dashboards wechseln per Tab in der Navbar oder über Einstellungen → Dashboards.

Widget-Controls

Im Bearbeitungsmodus (✏️ Button), über ein Widget hovern um Controls zu sehen:

Responsives Layout (Handy, Tablet & Desktop)

Das Dashboard schaltet anhand der Raster-Breite des Dashboards (der Bereich mit den Widgets — nicht nur die Browserfensterbreite) zwischen drei Modi:

Anpassen: Bearbeiten (✏️) aktivieren, beim Widget ⚙️ öffnen. Unten „Layout: Handy & Tablet“: optional Höhe / Mindesthöhe für die gestapelte Handy-Ansicht sowie Tablet-Position und -Größe. Felder leer lassen = für diesen Modus die Werte vom Desktop-Layout übernehmen.

Bei schmalen Viewports (ca. ≤ 1024 px) liegt die Navbar-Websuche in einer zweiten Zeile in voller Breite, damit sie nicht mit Zoom und Buttons um Platz kämpft.

Plugins können optional die Prop layoutMode ('phone' \| 'tablet' \| 'desktop') nutzen — siehe docs/PLUGIN_DEV.md.

Kiosk-Modus (Wand-Tablet)

Öffentliche Nur-Ansicht für Wand-Tablet oder Gast-Browser — getrennt vom normalen Dashboard mit Login.

Für Küchendisplay, Wand-Tablet oder gemeinsamen Bildschirm im LAN.

Einstellungen-Übersicht

Allgemein — Sprache (DE/EN), Dashboard-Titel, Navbar-Websuche, Navbar E-Mail, Navbar-Darstellung, Dashboard-Tab-Sichtbarkeit

Benutzer — Passwort ändern, 2FA (TOTP), Kiosk / Wand-Tablet (Admin). Admins verwalten hier zusätzlich Benutzer und Plugin-Freigaben.

Dashboards — Dashboards erstellen, bearbeiten, löschen. Tab-Sichtbarkeit pro Dashboard. Emoji oder PNG-Icon setzen.

Design — Navbar-Darstellung; Grid-Abstände; Navbar-Hintergrund (JPG/PNG + Overlay); Dashboard-Hintergrund (Aus / 1 Bild / 2 Bilder nebeneinander + Overlay); Logo; Farbthema; Farben einzeln anpassen

E-Mail — IMAP-Konten, Navbar-Badge, Abfrage-Intervall, Verbindung testen

Protokoll — Zentrales Fehlerprotokoll für Support und Fehlersuche: Filter nach Stufe, Quelle, Plugin; Download .txt / JSONL; Aufbewahrung 3 / 7 / 30 Tage. Jedes per registerPlugin eingebundene Plugin loggt Render-Fehler und fehlgeschlagene /api/*-Aufrufe automatisch. E-Mail nutzt dasselbe Protokoll mit Plugin-ID mail. Details: docs/LOGGING.md.

Umgebungsvariablen

Sicherheitshinweise

SelfDashboard ist für ein vertrauenswürdiges Heimnetz gebaut. Ein Security-Review (06/2026) hat die Auth- und Plugin-Flächen gehärtet; die folgenden Punkte sind relevant, sobald du die App über das LAN hinaus erreichbar machst.

Im Code gehärtet:

• Login-Brute-Force: Fehlversuche werden jetzt persistent pro Konto in SQLite gezählt (10 / 15 Min → temporäre Sperre). Das übersteht Neustarts und ist IP-unabhängig — ein gefälschter X-Forwarded-For-Header umgeht es nicht mehr.
• Fälschbare Proxy-Header werden ignoriert, außer SELFDASHBOARD_TRUST_PROXY=1 ist gesetzt (nur hinter echtem Reverse-Proxy).
• Admin-Aktionen erfordern abgeschlossene MFA: Benutzer-/Rollen-/Plugin-Verwaltung ist für Sessions ohne zweiten Faktor gesperrt.
• Rate-Limits für Passwort ändern und TOTP deaktivieren ergänzt.
• TOTP-Secrets werden verschlüsselt gespeichert (AES-256-GCM via SELFDASHBOARD_SECRET_KEY) — eine geleakte auth.db allein erlaubt keine gültigen 2FA-Codes mehr. Bestehende Enrollments werden transparent migriert.
• Docker-Container-Aktionen (Start/Stopp/Neustart) erfordern jetzt einen Admin mit abgeschlossener MFA — die reine Liste bleibt für Widget-Nutzer sichtbar.
• Plugin-Pack-Extraktion prüft jeden Zip-Eintrag gegen Path-Traversal (Zip-Slip) und begrenzt die Eintragszahl; Uploads haben ein hartes Limit.
• Plugin-SVG-Assets werden mit Content-Disposition: attachment, X-Content-Type-Options: nosniff und restriktiver CSP ausgeliefert → kein gespeichertes XSS über hochgeladene SVGs.

Betreiber-Verantwortung / bei öffentlicher Erreichbarkeit:

• HTTPS nutzen und SELFDASHBOARD_SECURE_COOKIES=1 setzen. Standard ist aus, damit reine HTTP-LAN-Setups funktionieren — über das Internet müssen Session-Cookies aber Secure sein.
• Plugin-Code läuft mit vollen Server-Rechten. Hochgeladene/Remote-Plugin-server.mjs-Dateien werden im Node-Prozess ausgeführt — ohne Sandbox. Installiere nur vertrauenswürdige Plugins und behandle den Admin-Account wie Shell-Zugriff.
• TLS-Prüfung für IMAP/FRITZ! kann pro Verbindung deaktiviert werden — lass sie an, außer es gibt einen konkreten Grund.
• Nutze ein starkes Admin-Passwort und einen festen SELFDASHBOARD_SECRET_KEY.

Bekannte nachrangige Punkte (noch nicht geändert): Die KDF der Credential-Verschlüsselung nutzt einen statischen Salt, und CalDAV hat keinen DNS-Rebinding-Schutz (IMAP/FRITZ! lösen die Ziel-IP bereits auf und prüfen sie). Im vertrauenswürdigen LAN geringes Risiko.

Troubleshooting

Technologie

• Frontend: Next.js 15, React 18, Tailwind CSS
• State: Zustand — im localStorage (Cache) und in dashboard.json auf dem Server, sobald /app/data bzw. SELFDASHBOARD_DATA_DIR verfügbar ist
• Grid: react-grid-layout
• Container: Node.js 22 Alpine (Multi-Stage, Next.js standalone)
• Plugins: Nur Volume — dynamisches widget.js + pluginRegistry; Katalog von GitHub plugins-pack/
• Entwicklung: npm run dev im Repo; Plugins veröffentlichen mit npm run publish:plugin-pack

Lizenz

MIT — kostenlos nutzbar, veränderbar und weiterzugeben.