Persönliches Homelab-Dashboard für Unraid

🇩🇪 Deutsch  |  🇬🇧 English

HELDASH ist ein selbst-gehostetes Homelab-Dashboard, speziell für Unraid. Es läuft als einzelner Docker-Container und bietet eine einheitliche Oberfläche für Services, Docker-Container, Media-Automation, Home Assistant, Netzwerkgeräte und mehr — mit Glass-Morphism UI, ohne Cloud-Abhängigkeit und ohne Subscription.

⚠️ Nutzung auf eigenes Risiko

Dieses Projekt wurde vollständig mit KI-Unterstützung (Claude Code) entwickelt. Es hat keine manuelle Code-Review durch einen professionellen Entwickler stattgefunden. Der Code wurde nicht auf Sicherheitslücken, Produktionsreife oder Best Practices geprüft.

Es wird ausdrücklich NICHT empfohlen, HELDASH öffentlich im Internet bereitzustellen. Das Dashboard ist ausschließlich für den Einsatz im lokalen Heimnetzwerk (LAN) gedacht.

Features

• Dashboard — Modulares Grid mit Apps, Widgets und Bookmarks; Drag & Drop, kollabierbare Gruppen, Per-User-Layouts
• Docker — Live-Container-Liste mit CPU/RAM, Log-Streaming, Echtzeit-Status via Docker Events
• Home Assistant — Multi-Instanz, Entity-Browser, Panel-Grid, Grundriss, GPS-Tracking, Automationen, Energie-Dashboard, Entity-Verlauf
• Media — Radarr, Sonarr, Prowlarr, SABnzbd, Seerr/Discover, qBittorrent mit Statistiken, Queues und Kalendern
• Recyclarr + CF-Manager — TRaSH Guides Sync GUI, Custom-Format-Editor, Import/Export
• Unraid Integration — Array & Disk-Übersicht, Cache Pools, VM-Management, Notifications, Plugins, Logs, UPS
• Netzwerk-Monitor — TCP-Ping, 7-Tage-Historie, IP-Scanner, Wake-on-LAN, Geräte-Gruppen
• Widgets — Server-Stats, AdGuard/Pi-hole, Docker, Nginx PM, HA Entities, Wetter, Kalender
• Icon-System — 1800+ Icons von dashboardicons.com + Custom-Upload, Icon-Picker für alle Entities
• Auth & Zugriff — Lokale Nutzer, Gruppen (Admin, Gast, Custom), Per-Gruppe-Sichtbarkeit, „Angemeldet bleiben"
• i18n — Deutsch (Standard) + Englisch; Community-Übersetzungen willkommen
• Design — Glass Morphism, Hell/Dunkel, 3 Akzentfarben, Auto-Theme, Custom CSS, Hintergrundbilder

Installation

Unraid Community Apps (empfohlen)

1. Apps-Tab in Unraid öffnen
2. Nach HELDASH suchen
3. Install klicken und Template folgen

HELDASH ist dann erreichbar unter http://SERVER-IP:8282.

Docker Compose

services:
  heldash:
    image: ghcr.io/kreuzbube88/heldash:latest
    container_name: heldash
    restart: unless-stopped
    ports:
      - "8282:8282"
    volumes:
      - /mnt/user/appdata/heldash:/data
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /mnt/user/appdata/recyclarr:/recyclarr
      # - /boot:/boot:ro  # optional: CA Backup Monitoring
    environment:
      - SECRET_KEY=your_secret_here   # openssl rand -hex 32
      - SECURE_COOKIES=false          # true wenn hinter HTTPS-Proxy

Docker CLI

docker run -d \
  --name heldash \
  -p 8282:8282 \
  -v /mnt/user/appdata/heldash:/data \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /mnt/user/appdata/recyclarr:/recyclarr \
  -e SECRET_KEY=$(openssl rand -hex 32) \
  -e SECURE_COOKIES=false \
  ghcr.io/kreuzbube88/heldash:latest

Umgebungsvariablen

Voraussetzungen

• Docker socket /var/run/docker.sock — erforderlich für Docker-Integration
• Data-Volume /data — Datenbank, Icons und Konfiguration
• Recyclarr-Volume /recyclarr — optional, für Recyclarr-Sync
• Boot-Mount /boot — optional, für CA Backup Monitoring

Dokumentation

Die vollständige Dokumentation ist im docs/-Verzeichnis verfügbar — auf Deutsch und Englisch.

Contributing

Contributions sind willkommen! Siehe CONTRIBUTING.md.

Besonders gesucht:

• 🌐 Übersetzungen (Französisch, Spanisch, Italienisch, etc.)
• 📖 Dokumentations-Verbesserungen
• 🐛 Bug Reports mit Reproduktionsschritten

Lizenz

MIT © HEL*Apps