ITSWEBER Mesh (Home Dashboard)
Dokumentation zu ITSWEBER Mesh, dem selbst gehosteten Dashboard für dein Homelab. Schnellstart, Docker-Installation, Widgets, Integrationen und Fehlerbehebung.
Setup
- Schnellstart Von 0 zu einem laufenden ITSWEBER Mesh in unter 5 Minuten. Voraussetzungen Docker (Linux, macOS oder Windows mit WSL2) Ein freier Port — Def…
- Docker-Installation Im Detail. Für die Schnell-Variante: Schnellstart. docker run vs docker-compose Use-Case Empfehlung Mal eben testen docker run Permanente In…
- ITSWEBER Mesh auf Unraid installieren Unraid ist eines der primären Ziele von ITSWEBER Mesh — wenn du Unraid 6.10+ läufst, ist die Installation ein Drei-Klick-Vorgang. Voraussetz…
- First-Run-Wizard Beim allerersten Aufruf einer leeren Mesh-Installation läuft ein 3-Schritte-Setup-Wizard, bevor das eigentliche Dashboard angezeigt wird. Sc…
Konzepte
- Services vs Widgets — Wann nehme ich was? Mesh hat zwei Konzepte, die auf den ersten Blick ähnlich wirken: Services und Widgets. Sie haben aber sehr unterschiedliche Aufgaben. Servic…
- Boards — mehrere Dashboards im selben Mesh Boards sind die Mesh-Antwort auf „aber ich hätte gerne ein eigenes Dashboard für meine Wohnung, eines für die Firma und eines fürs Studio". …
- Themes & Aussehen anpassen Mesh kommt mit 7 Theme-Presets und einer Custom-CSS-Schleuse für Pixel-Genaues. Die 7 Presets Preset Charakter dark Standard. Navy-Petrol-Gr…
- Auth-Modi — wer darf was? Mesh hat ein pluggable Auth-System mit 4 Modi. Jeder Modus ist eine Strategy-Klasse in apps/web/src/server/auth/. Übersicht Modus Wer kann z…
- Healthchecks — wie der Status-Punkt funktioniert Mesh hat einen in-process Healthcheck-Scheduler — kein externer Cron, kein zusätzlicher Container. Wie es läuft Intervall: alle 10 Sekunden …
- Command Palette (Strg + K) Die Suchleiste oben rechts im Header öffnet ein Modal mit zwei Sektionen: Lokale Treffer + Web-Suche. Aufrufen Klick auf die Suchleiste Tast…
Integrationen
- Integrationen — Überblick Mesh hat aktuell 14 first-class Integrationen. Jede ist ein eigener Slot unter Admin → Integrationen und liefert Daten für eines oder mehrer…
- Home Assistant Mesh-zu-HA-Integration über REST-API + Long-Lived Access Token. Was die Integration kann Smart-Home-Widget mit Personen-Status, Energie-Verb…
- Glances-Integration Glances ist ein Python-basiertes System-Monitoring-Tool, das eine REST-API bereitstellt. Mesh nutzt es, um die Server-Karten (InfraNodes) au…
- AdGuard Home DNS-Filter mit Statistiken via REST-API + Basic-Auth. Was die Integration kann AdGuard-Widget mit Block-Rate (24 h), DNS-Queries, Top-Adlist…
- Pi-hole DNS-Filter via REST-API + API-Token. Multi-Instance unterstützt — pflege beliebig viele Pi-holes parallel. Was die Integration kann DNS-Quer…
- UniFi Network UniFi-Controller-Integration (UDM Pro / Cloud Key / selbst-gehostet) via API-Key. Was die Integration kann WAN-Status (online/offline, exter…
- UniFi Protect NVR + Kameras von UniFi Protect. Snapshot-Proxy + optional Live-Stream-Link. Was die Integration kann Aktuelle Kamera-Snapshots (gepullt vom…
- Portainer Container-Management-UI über Portainer-API + API-Key. Multi-Instance (z. B. CORE + NODE separat). Was die Integration kann Container-Listung…
- Frigate NVR mit Object-Detection. Mesh zeigt die letzten Events mit Thumbnails. Was die Integration kann Letzte N Events (default 10) mit Thumbnail …
- ESPHome (Direct-Modus) Direkte Integration zu ESPHome-Geräten — ohne Home Assistant als Vermittler. Multi-Instance (eine pro Gerät). Was die Integration kann Senso…
- Zigbee2MQTT Drei Modi für die Z2M-Integration — wähle den, der zu deinem Setup passt. Was die Integration kann Geräte-Liste (online/offline) mit Akku-St…
- Uptime Kuma Status-Page-Monitor — Mesh zeigt deine Uptime-Kuma-Status-Page eingebettet. Was die Integration kann Monitor-Liste mit Health-Status Aktuell…
- Speedtest-Tracker Internet-Speedtest mit History via alex-laycalvert/speedtest-tracker oder LSIO-Image. Was die Integration kann Aktuelle Download / Upload / …
- Wetter (Open-Meteo) Aktuelles Wetter + 5-Tage-Forecast. Datenquelle ist Open-Meteo — kein API-Key nötig. Was die Integration kann Aktuelle Temperatur + Bewölkun…
- Custom REST Beliebiger JSON-Endpoint → Mesh-Widget. Mit JSONPath-Mapping. Was die Integration kann Jeden HTTP-GET-Endpoint mit JSON-Response anzapfen JS…
Operations
- Backups & Schema-Migrations Mesh persistiert seine ganze Konfiguration in einer einzigen JSON-Datei und schützt sie automatisch vor Schema-Änderungen. Wo liegt die Konf…
- Troubleshooting Häufige Probleme + Lösungen, sortiert nach Symptom. Container Container startet nicht / Exit-Code 1 sofort beim Start Prüfe Logs: docker log…
- Architektur (für Entwickler) Wie Mesh innen aufgebaut ist. Falls du PRs machen willst, eigene Widgets baust oder einfach neugierig bist. High-Level ┌────────────────────…