GroupAlarm Add-on für Home Assistant 🚒

Overview

Das GroupAlarm Add-on bindet dein GroupAlarm-System in Home Assistant ein.
Es bietet eine moderne Ingress-Oberfläche mit den Tabs Alarme (Standard) und Quick-Actions, zeigt Einsatzorte auf einer Karte (Leaflet), verwaltet Orga-Avatare und erstellt per MQTT Discovery passende Entitäten – ideal für Dashboards und Automationen.

Installation

Add-on Store (empfohlen)

1. In Home Assistant Einstellungen → Add-ons → Add-on Store öffnen.
2. Über Menü (⋮) Repositories dieses Repo hinzufügen. https://github.com/DasAuryn/GroupAlarm-HomeAssistant
3. GroupAlarm Add-on installieren.
4. In den Einstellungen die Konfiguration vornehmen (siehe unten).
5. Add-on starten und über Ingress öffnen.

Manuell

Alternativ kann das Add-on (z. B. via Docker) manuell deployt werden. Lade das Release von GitHub und starte mit passenden Umgebungsvariablen (siehe Konfiguration). Für Supervisor-Setups ist der Add-on-Store der einfachste Weg.

Configuration

Using UI

Die wichtigsten Optionen:

• API_BASE_URL – z. B. https://app.groupalarm.com/api/v1
• TOKEN – dein GroupAlarm Personal Access Token
• MQTT_HOST, MQTT_PORT, MQTT_USERNAME, MQTT_PASSWORD

Wie bekomme ich meinen API-Token?

1. In GroupAlarm einloggen.
2. In den Kontoeinstellungen einen Personal Access Token erstellen/kopieren.
3. In der Add-on-Konfiguration TOKEN setzen und – falls nötig – HEADER_NAME an deine Instanz anpassen.

Usage

Nach dem Start steht die Ingress-UI bereit:

• Alarme (Standard-Tab)
  Zeigt aktuelle Alarme pro Orga inkl. Adresse und Kartenmarker.
  Die Seite prüft alle paar Sekunden eine Signatur unter /alarms.json und lädt nur bei Datenänderung neu.

• Quick-Actions
  Zeigt pro Orga Alarmbuttons.

Entities

Dieses Add-on stellt u. a. bereit:

• Binary Sensor je Orga: „Alarm aktiv“
  Wird bei Eingang eines Alarms on und geht nach 5 Sekunden automatisch auf off zurück (ideal für Flanken-Trigger).

Help and Contribution

Probleme oder Wünsche?
Erstelle ein Issue oder sende einen Pull Request – Beiträge sind willkommen!

Disclaimer

Dieses Add-on ist nicht offiziell mit GroupAlarm verbunden.
Die Nutzung erfolgt auf eigenes Risiko. Bitte beachte:

• Rechtmäßige Verarbeitung (insb. DSGVO),
• Schutz sensibler personenbezogener Daten,
• sichere Konfiguration deiner Home-Assistant-Instanz (starke Passwörter, TLS, Updates).

Je nach Setup können sensible Einsatz-/Personaldaten angezeigt werden. Sorge für eine geeignete Rechtsgrundlage und angemessene technische/organisatorische Maßnahmen.

---