Hilfe für deinen Import.

Einrichten

Benötigt werden ein iPhone mit iOS 17 oder neuer und eine erreichbare Home-Assistant-Instanz. Der Einrichtungsassistent lässt sich jederzeit in den Einstellungen öffnen.

1. Mindestens eine Home-Assistant-Adresse hinterlegen. Eine externe Adresse und der Weblogin benötigen HTTPS.
2. Über die Home-Assistant-Anmeldeseite anmelden oder einen langlebigen Token manuell beziehungsweise per QR-Code übernehmen. Ein optionales Clientzertifikat gehört zur Verbindung.
3. Import-Sensoren den passenden Datentypen in Apple Health zuordnen. Einen optionalen Export anschließend getrennt auswählen.
4. Die passenden Apple-Health-Freigaben anfragen. Danach die Importvorschau prüfen und einen manuellen Abgleich starten.

Für einen ersten Blick ohne eigene Daten öffnet Demo im Einrichtungsassistenten den gekennzeichneten Demomodus. Alternativ wähle Einstellungen → Über HA Health Bridge → Demomodus öffnen. Alle Beispiele sind fiktiv; es findet keine echte Übertragung statt.

Verbindung prüfen

Prüfe zuerst, ob deine Home-Assistant-Adresse erreichbar und vollständig eingetragen ist. Interne und externe URL müssen dieselbe Instanz erreichen. Bei einem abgelaufenen oder widerrufenen Zugang kannst du dich erneut anmelden.

HTTPS und Heim-WLAN

Eine externe URL muss HTTPS verwenden. Für eine interne HTTP-Verbindung muss die vollständige App-Variante das gespeicherte Heim-WLAN aktuell erkennen. iOS verlangt dafür eine passende Standortfreigabe mit genauem Standort; im Hintergrund kann „Immer“ nötig sein. HA Health Bridge fragt keine geografischen Koordinaten ab.

Ohne WLAN-Erkennung wird eine konfigurierte HTTPS-Adresse verwendet. Installationen ohne diese Funktion unterstützen keine interne HTTP-Verbindung. Ein Netzwerkfehler gibt keinen unsicheren HTTP-Ersatzweg frei.

Clientzertifikate

Falls dein Server mTLS verlangt, importiere die passende PKCS#12-Datei und aktiviere das Clientzertifikat. Die Server-Zertifikatsprüfung bleibt bei iOS. Achte auf gültige Zertifikate und einen zum Server passenden Hostnamen.

Apple-Health-Freigaben

Wähle zuerst die benötigten Zuordnungen und Export-Datentypen. Unter Einstellungen → Apple Health freigeben kannst du die iOS-Anfrage für diese Auswahl erneut anstoßen.

iOS zeigt den Dialog nur für noch nicht entschiedene Freigaben. Bereits erlaubte oder verweigerte Rechte änderst du direkt in Apple Health beziehungsweise den iOS-Einstellungen. Eine neue Anfrage erzwingt keinen erneuten Systemdialog.

Eine Freigabe allein überträgt noch keine Daten. Zum Prüfen einer Sensorzuordnung kannst du die Importvorschau nutzen; sie schreibt keine Werte nach Apple Health.

Vorschau und Berichte

Die Importvorschau zeigt neue, bekannte, korrigierte, ausgelassene und noch offene Messungen. Prüfe bei fehlenden Werten die Quellentität, das gewählte Attribut, Einheit und Zeitangaben sowie den in Home Assistant gespeicherten Verlauf.

Importberichte zeigen den Stand je Zuordnung. Beim optionalen Export muss mindestens ein lesbarer Datentyp ausgewählt und freigegeben sein. Bestehende eigene Importe werden vom Rückweg ausgeschlossen.

Apple-Health-Exporte erscheinen als Sensorzustände. Die optionale HA Health Bridge-Integration in Home Assistant kann sie im Entitätsregister anlegen. Vergangene Apple-Health-Messungen werden dadurch nicht rückwirkend als historische Recorder-Einträge angelegt.

iOS steuert die Hintergrundausführung. Ein fester Übertragungstakt ist nicht zugesichert; ein manueller Abgleich bleibt die direkte Möglichkeit, den aktuellen Stand zu prüfen.

Optionale Home-Assistant-Integration

Für den optionalen Export von Apple Health nach Home Assistant gibt es die HA Health Bridge-Integration für Home Assistant 2026.11 oder neuer. Sie legt die übertragenen Werte als registrierte Sensoren an und ordnet jeder iPhone-Exportquelle ein eigenes Gerät zu. Dauerhafte Kennungen erhalten deine in Home Assistant angepassten Namen, Entity-IDs, Symbole und Bereiche bei weiteren Exporten.

Das öffentliche Marketplace-Repository von HA Health Bridge auf GitHub enthält den Quellcode unter Apache-2.0, die Voraussetzungen und die Installationsanleitung.

Trennen und Daten löschen

Home-Assistant-Verbindung trennen

Die Aktion entfernt die lokal gespeicherte Anmeldung und das Clientzertifikat, pausiert die Automatik und schaltet den Apple-Health-Export aus. Deine Konfiguration und Zuordnungen bleiben erhalten. Ein OAuth-Widerruf am Server wird soweit möglich versucht; bei Nichterreichbarkeit muss der Zugang zusätzlich im Home-Assistant-Profil widerrufen werden. Langlebige Tokens entfernst du dort bei Bedarf selbst.

Lokale App-Daten löschen

Nach Bestätigung werden App-Einstellungen, Übertragungsjournale, lokale Zugangsdaten, das Clientzertifikat und die Exportquellenkennung entfernt. Die Aktion ist während laufender Vorgänge gesperrt.

Entferne Apple-Health-Datensätze, Home-Assistant-Sensoren, Recorder-Verlauf und Sicherungen bei Bedarf getrennt in den jeweiligen Systemen. Auch ein reines Entfernen der App löscht Schlüsselbundeinträge nicht verlässlich. Nutze zuvor die Trenn- oder Löschfunktion und widerrufe Tokens auf dem Server.

Support kontaktieren

Beschreibe die betroffene Datenrichtung, den beobachteten Fehler und die Schritte zum Nachstellen. Hilfreich sind iOS-Version, App-Version und die Frage, ob die Verbindung intern oder über HTTPS erfolgt.

Anbieter

Thomas Michel

Support-E-Mail

ha-health-bridge@michelnet.ch

Auf dieser Website gibt es kein Kontaktformular und keinen Datei-Upload. Für Rückfragen nutze bitte die E-Mail-Adresse.

Wie lokale Daten, Übertragungen und Supportanfragen eingeordnet werden, beschreibt der Datenschutz.