AmberChest für Home Assistant

Die Integration bringt die Zahlen und die Steuerung von AmberChest nach Home Assistant. Sie fragt die HTTP-Schnittstelle einer AmberChest-Instanz ab und macht daraus Entitäten. Alles läuft lokal, ohne Cloud, ohne Konto und ohne Broker. Das Projekt ist inoffiziell und steht unter der MIT-Lizenz.

Was entsteht

• Ein Gerät je Postfach mit der Zahl der gesicherten Nachrichten, der Archivgröße, den erfassten Ordnern und dem Zeitpunkt der letzten Sicherung; die Zahlen des Laufs hängen als Attribute daran.
• Ein Binärsensor, der an ist, solange gesichert wird, mit Ordner und Fortschritt als Attribute.
• Ein Knopf, der eine Sicherung startet, und einer, der sie abbricht. Standardmäßig ist nur der Startknopf aktiv.
• Ein Gerät für die Instanz mit der Gesamtgröße des Archivs und dem nächsten geplanten Lauf. Letzterer ist nur im Container bekannt, weil die Desktop-App keinen Zeitplan hat.
• Eine Lovelace-Karte, die ihre Postfächer selbst findet und automatisch als Ressource registriert wird.

Die Entitäts-IDs entstehen aus dem Namen des Kontos in AmberChest, zum Beispiel sensor.privat_nachrichten oder button.privat_jetzt_sichern. Home Assistant bildet sie aus dem übersetzten Namen, deshalb unterscheiden sie sich von der englischen Fassung.

Wie es funktioniert

Ein Koordinator je Instanz fragt alle 30 Sekunden /api/accounts und /api/schedule ab. Die Sitzungstoken von AmberChest überleben keinen Neustart des Servers; der Client meldet sich deshalb von selbst neu an, sobald eine Anfrage mit 401 zurückkommt. Nach einem Knopfdruck wird sofort neu geladen. Mehrere Instanzen lassen sich nebeneinander einrichten, jede bekommt eigene Geräte.

Installation

1. In HACS unter „Benutzerdefinierte Repositorys“ die URL https://github.com/sphings79/amberchest-home-assistant mit der Kategorie „Integration“ eintragen.
2. AmberChest installieren und Home Assistant neu starten.
3. Unter „Einstellungen → Geräte & Dienste“ die Integration „AmberChest“ hinzufügen und Host, Port (8484), das Passwort der Oberfläche und bei Bedarf HTTPS eintragen.

Die Karte wird auf ein Dashboard gelegt:

type: custom:amberchest-card
title: Mail-Sicherung   # optional
hide_empty: false       # optional, blendet leere Postfächer aus

Voraussetzungen und Abgrenzung

Gebraucht wird eine laufende AmberChest-Instanz ab Version 2.0.0, die Home Assistant über HTTP erreicht; nötig ist Home Assistant 2025.9 oder neuer. Die Integration liest Zähler, Zeitstempel, den Postfachnamen und den Ordner, an dem eine Sicherung gerade arbeitet, aber keine Mail-Inhalte. Alternativ kann AmberChest dieselben Zahlen per MQTT veröffentlichen; beide Wege dürfen nebeneinander laufen. Wer ohnehin einen Broker betreibt und den Zustand sofort haben will, ist mit MQTT besser bedient, sonst ist die Integration weniger Aufwand. Eine Instanz, die als Add-on läuft, braucht für die Integration einen freigegebenen Port und ein Oberflächen-Passwort (siehe das Add-on).