Home Assistant-app maakt geen verbinding op iPhone: oorzaken en oplossingen

Begin met updates en de eigen controles van de app

Werk de Home Assistant-app en Home Assistant bij voordat je iets anders doet: verschillende verbindingsproblemen in 2026 waren fouten in één versie, niet in iemands installatie, en de tabel zet ze op een rij. Laat de app daarna zien wat hij ziet. Open in de app Instellingen > Companion app en kies je server om bij “Serverdetails” te komen. Daar staat “Momenteel in gebruik” bij het adres dat nu wordt gebruikt. Kies daar een adres, dan “Wijzig” en “Verschil tussen interne en externe URL”: die pagina somt de voorwaarden voor je lokale adres op, vinkt de vervulde aan en toont het “Beveiligingsniveau van verbinding”. Is geen adres bruikbaar, dan toont “Serverdetails” in plaats van “Synchroniseer” de knop “Probleemoplossing”, die dezelfde pagina opent. Laadt het dashboard helemaal niet, dan toont het foutscherm een code, de knop “Open instellingen” en “Connectiviteit diagnose”, die DNS, de poort, het certificaat en de server een voor een test.

Werkt onderweg, niet op je eigen wifi

De app kiest een adres op basis van de naam van het wifinetwerk waarop hij zit, nooit op basis van gps of zones. De “Interne URL” gebruikt hij alleen op de wifinetwerken die voor je server zijn ingesteld, en overal elders Home Assistant Cloud of de “Externe URL”. Geeft iOS de app de wifi-naam niet, of staat de naam niet in de lijst, dan lijkt je huis voor de app op elke andere plek. “Locatie”, “Lokaal netwerk” en “Mobiele data” staan allemaal op de pagina van de app onder Instellingen > Apps > Home Assistant.

• Elke wifi-naam toevoegen: Open in “Serverdetails” de “Interne URL” en voeg onder “Thuisnetwerk” elk netwerk toe dat je thuis gebruikt, ook een aparte 5 GHz-naam, mesh- of extendernamen en een IoT-netwerk. Sinds app 2026.9.3 vraagt de installatie het eerst voordat je huidige wifi als thuis wordt opgeslagen; sla je die stap over, dan blijft de lijst leeg.
• Exacte locatie aanzetten: iOS geeft de wifi-naam alleen aan apps met een exacte locatie. Zet “Exacte locatie” aan via Instellingen > Privacy en beveiliging > Locatievoorzieningen > Home Assistant. Voor de app zelf is “Bij gebruik van app” genoeg; kies “Altijd” als widgets, Opdrachten, acties in meldingen en sensoren het lokale adres ook op de achtergrond moeten gebruiken.
• Beveiligingsniveau controleren: Bij een “Interne URL” met gewone http laat de app je een “Beveiligingsniveau van verbinding” kiezen. “Meest veilig” gebruikt dat adres alleen op de ingestelde netwerken; zonder locatietoegang maakt de app dan nergens verbinding en toont “De verbinding is verbroken”. “Minder veilig” gebruikt het op elk netwerk, ook op openbare wifi, waar de verbinding niet versleuteld is. Een https-adres maakt de keuze overbodig.
• Twee plekken, één wifi-naam: Een vakantiehuis of een reisrouter met dezelfde netwerknaam lijkt voor de app op je huis, en hij probeert daar ook het lokale adres. Geef een van de netwerken een andere naam.

Safari opent Home Assistant, de app niet

Dat wijst op de toestemming “Lokaal netwerk” van de iPhone. Safari heeft die niet nodig, maar de eigen verbinding van de app met een lokaal adres wel, net als elke naam op homeassistant.local. Een adres dat via internet naar buiten gaat, zoals Home Assistant Cloud, werkt zonder. Daarom maakt de app misschien nog verbinding via de cloud terwijl het lokale adres faalt. Het foutscherm meldt dan vaak dat de internetverbinding offline lijkt, code -1009, terwijl de wifi gewoon werkt.

• De schakelaar controleren: Open Instellingen > Privacy en beveiliging > Lokaal netwerk en zet Home Assistant aan.
• Staat hij al aan: Zet hem uit en weer aan, sluit de app in de appkiezer en open hem op je wifi thuis. Helpt dat niet, herstart dan de iPhone. Apple heeft gevallen in iOS 17, iOS 18 en macOS beschreven waarin de schakelaar aan stond maar de toegang niet.
• Na opnieuw installeren: Als je de app verwijdert, wordt de toestemming gewist. Open de app op je wifi thuis en sta de vraag toe. Komt de eerste lokale verbinding van een widget of een melding op de achtergrond, dan weigert iOS die zonder te vragen, en verschijnt de app misschien pas in de lijst als hij verbinding maakt terwijl hij open is.

Wat de foutcodes betekenen

Het foutscherm toont een code van iOS. Dezelfde code kan meer dan één oorzaak hebben, dus begin bij de eerste stap.

Werkt thuis, niet onderweg

Buiten je ingestelde wifinetwerken gebruikt de app Home Assistant Cloud als die schakelaar aan staat, en anders de “Externe URL”. Zonder allebei is Home Assistant alleen thuis bereikbaar.

• Home Assistant Cloud: Open in Home Assistant Instellingen > Home Assistant Cloud > Externe toegang en zet “Verbinding op afstand” aan. Open in de app in “Serverdetails” de “Externe URL” en zet Home Assistant Cloud aan. De schakelaar verschijnt daar pas als “Verbinding op afstand” aan staat. Vanaf 2 december 2026 heet Home Assistant Cloud Home Assistant Link; het abonnement blijft hetzelfde.
• Eigen adres of een vpn: Vul het in als “Externe URL”. iOS kan een vpn niet als je thuisnetwerk herkennen, dus het adres dat je via Tailscale of WireGuard bereikt hoort in de “Externe URL”, met de vpn aan zodra je weg bent.
• Mobiele data uit voor de app: Instellingen > Mobiel netwerk toont elke app met een schakelaar; die van Home Assistant moet aan staan.
• Port forwarding komt nooit aan: Veel internetverbindingen delen één openbaar adres met andere klanten (CGNAT, of DS-Lite op sommige kabel- en glasvezelaansluitingen), waardoor doorgestuurde poorten nooit bij je thuis aankomen. Home Assistant Cloud, Tailscale of een Cloudflare Tunnel werken zonder open poort.
• Je domein faalt alleen thuis: Sommige routers kunnen een verzoek naar je openbare adres niet terugsturen naar je thuisnetwerk. Stel een “Interne URL” in en zet je wifi-namen erbij, dan gebruikt de app thuis het lokale adres.

Vast na een wachtwoordwijziging, herstel of verhuizing

Accepteert Home Assistant de login van de app niet meer, na een wachtwoordwijziging, een teruggezette back-up of een verhuizing naar een nieuw adres, dan kan de app het blijven proberen in plaats van je te laten inloggen. Hij toont “Kan niet verbinden met Home Assistant” of “De sessie is verlopen”, terwijl je in Safari gewoon inlogt. De app opnieuw installeren helpt niet, omdat de server terugkomt uit de sleutelhanger van de iPhone.

• Opnieuw aanmelden: Kies in “Serverdetails” “Re-authenticate”. De app logt opnieuw in en houdt je adressen en instellingen.
• Server verwijderen en opnieuw toevoegen: Lukt dat niet, kies dan “Verwijder server” in “Serverdetails”, sluit de app en voeg de server opnieuw toe. Vanaf een kapot dashboard brengt “Open instellingen” op het foutscherm je daar.
• Opruimen: Staat de iPhone daarna dubbel in Home Assistant onder Instellingen > Apparaten en diensten > Mobile App, verwijder dan de oude.

Poorten, netwerken en blokkers

Kan Safari op dezelfde iPhone het lokale adres ook niet openen, dan ligt het aan het netwerk, niet aan de app.

• Nieuwe installaties, nieuwe poort: Installaties van Home Assistant OS die met 2026.8 of nieuwer zijn opgezet, antwoorden op een gewoon adres, http://homeassistant.local, zonder :8123. Bestaande installaties houden hun poort. Gebruik het adres dat in Safari opent.
• Gasten- en IoT-netwerken: Een iPhone op een ander netwerk of VLAN dan Home Assistant heeft een route en een firewallregel nodig om het te bereiken, en namen op homeassistant.local komen zonder mDNS-reflector niet over netwerkgrenzen. Ga op hetzelfde netwerk of gebruik het IP-adres. Clientisolatie op een gastenwifi blokkeert het helemaal.
• Adblockers en DNS-filters: Apps die filteren via een vpn of een DNS-profiel kunnen je domein, duckdns.org of nabu.casa blokkeren. Pauzeer het filter om te testen en sta daarna je Home Assistant-adres toe.
• DNS-rebindbeveiliging: Routers zoals de FRITZ!Box weigeren namen die naar een privéadres wijzen. Leidt je eigen domein thuis naar je thuis-IP, voeg het dan toe als uitzondering in de DNS-rebindbeveiliging van de router; op een FRITZ!Box onder Thuisnetwerk > Netwerk > Netwerkinstellingen.

Certificaten, proxy’s en blokkades

Dit speelt als Home Assistant met https op je eigen adres of achter een proxy draait.

• Zelfondertekende certificaten: De app biedt “Certificaat vertrouwen” aan als je de server toevoegt. Vervang je het certificaat later, dan vraagt hij het niet opnieuw, dus verwijder de server en voeg hem opnieuw toe. Je eigen certificeringsinstantie op de iPhone installeren en aanzetten onder Instellingen > Algemeen > Info > Certificaatbetrouwbaarheidsinstellingen werkt ook.
• Certificaat voor een andere naam: Een verbinding via https met een IP-adres mislukt als het certificaat voor je domein is, omdat de namen niet overeenkomen. Gebruik http voor het lokale IP-adres, of een lokale DNS-vermelding voor het domein.
• Reverse proxy, fout 400: Home Assistant weigert verzoeken van een proxy die het niet vertrouwt en logt “A request from a reverse proxy was received”. Sinds Home Assistant 2026.8 staat de oplossing onder Instellingen > Systeem > Netwerk > HTTP-server: zet “X-Forwarded-For vertrouwen” aan en voeg het adres van de proxy toe onder “Vertrouwde proxy’s”. De proxy moet ook WebSocket-verbindingen doorlaten.
• Geblokkeerd IP, fout 403: Home Assistant blokkeert niemand, tenzij het aantal inlogpogingen in dezelfde instellingen van de HTTP-server is beperkt. Een blokkade verloopt nooit vanzelf: verwijder het adres uit ip_bans.yaml in de configuratiemap en start Home Assistant opnieuw op.

Waar Vulpo past

Vulpo is een native Home Assistant-app voor iPhone, iPad, Mac en Apple Watch. Vulpo leest de wifi-naam op dezelfde manier, dus de stappen voor “Lokaal netwerk” en “Exacte locatie” hierboven gelden ook hier. Het verschil: reageert het lokale adres niet meer, dan schakelt Vulpo vanzelf over naar je externe adres, en staat de toestemming “Lokaal netwerk” uit, dan zegt de app dat in plaats van het te blijven proberen. Met Home Assistant Cloud vindt Vulpo het externe adres zelf, zonder “Externe URL”. Accepteert Home Assistant de login niet meer, dan toont Vulpo de sessie als verlopen en biedt het aan om opnieuw in te loggen of een toegangstoken te gebruiken. Vulpo heeft iOS 26 of nieuwer nodig. Vulpo wordt gemaakt door de uitgever van deze site.