ITSWEBER Mesh (Home Dashboard)
Dokumentation zu ITSWEBER Mesh, dem selbst gehosteten Dashboard für dein Homelab. Schnellstart, Docker-Installation, Widgets, Integrationen und Fehlerbehebung.
Setup
- Docker Installation For the quick version: Quick Start. docker run vs docker-compose Use case Recommendation Quick test docker run Permanent installation docker…
- Installing ITSWEBER Mesh on Unraid Unraid is one of the primary targets for ITSWEBER Mesh — if you are running Unraid 6.10+, installation is a three-click process. Prerequisit…
- First Run Wizard On the very first visit to a fresh Mesh installation a 3-step setup wizard runs before the actual dashboard is shown. Step 1 — Identity Dash…
- Quick Start From zero to a running ITSWEBER Mesh in under 5 minutes. Prerequisites Docker (Linux, macOS or Windows with WSL2) A free port — default is 3…
Konzepte
- Services vs Widgets — When to use which? Mesh has two concepts that look similar at first glance: Services and Widgets. They have very different purposes however. Services — the lau…
- Boards — multiple dashboards in one Mesh Boards are Mesh's answer to "I'd like a separate dashboard for my home, one for work and one for the studio". Each board has its own slug, o…
- Themes & Customising the look Mesh ships with 7 theme presets and a Custom CSS slot for pixel-perfect tuning. The 7 presets Preset Character dark Default. Navy-petrol bas…
- Auth Modes — who can access what? Mesh has a pluggable auth system with 4 modes. Each mode is a strategy class in apps/web/src/server/auth/. Overview Mode Who can access? Who…
- Healthchecks — how the status dot works Mesh has an in-process healthcheck scheduler — no external cron, no additional container. How it works Interval: a full sweep every 10 secon…
- Command Palette (Ctrl + K) The search bar in the top right of the header opens a modal with two sections: local results + web search. Opening Click the search bar Keyb…
Integrationen
- Integrations — Overview Mesh currently has 14 first-class integrations. Each is its own slot under Admin → Integrations and provides data for one or more widgets. L…
- Home Assistant Mesh-to-HA integration via REST API + Long-Lived Access Token. What the integration can do Smart Home widget with person status, energy cons…
- Glances Integration Glances is a Python-based system monitoring tool that exposes a REST API. Mesh uses it to feed the server cards (InfraNodes) on the dashboar…
- AdGuard Home DNS filter with statistics via REST API + Basic Auth. What the integration can do AdGuard widget with block rate (24 h), DNS queries, top ad…
- Pi-hole DNS filter via REST API + API token. Multi-instance supported — manage as many Pi-holes as you like in parallel. What the integration can do…
- UniFi Network UniFi controller integration (UDM Pro / Cloud Key / self-hosted) via API key. What the integration can do WAN status (online/offline, extern…
- UniFi Protect NVR + cameras from UniFi Protect. Snapshot proxy + optional live stream link. What the integration can do Current camera snapshots (pulled b…
- Portainer Container management UI via Portainer API + API key. Multi-instance (e.g. CORE + NODE separately). What the integration can do Container lis…
- Frigate NVR with object detection. Mesh shows the latest events with thumbnails. What the integration can do Latest N events (default 10) with thumb…
- ESPHome (Direct Mode) Direct integration with ESPHome devices — without Home Assistant as intermediary. Multi-instance (one per device). What the integration can …
- Zigbee2MQTT Three modes for the Z2M integration — choose the one that fits your setup. What the integration can do Device list (online/offline) with bat…
- Uptime Kuma Status page monitor — Mesh shows your Uptime Kuma status page embedded. What the integration can do Monitor list with health status Current …
- Speedtest Tracker Internet speed test with history via alex-laycalvert/speedtest-tracker or the LSIO image. What the integration can do Current download / upl…
- Weather (Open-Meteo) Current weather + 5-day forecast. Data source is Open-Meteo — no API key required. What the integration can do Current temperature + cloud c…
- Custom REST Any JSON endpoint → Mesh widget. With JSONPath mapping. What the integration can do Tap any HTTP GET endpoint with a JSON response JSONPath …
Operations
- Backups & Schema Migrations Mesh persists its entire configuration in a single JSON file and automatically protects it from schema changes. Where is the configuration? …
- Troubleshooting Common problems + solutions, sorted by symptom. Container Container does not start / exit code 1 immediately on start Check logs: docker log…
- Architecture (for contributors) How Mesh is built internally. Useful if you want to submit PRs, build your own widgets, or are just curious. High-level overview ┌──────────…