home-assistant
iOS White Screen
iOS device model, version and app version:
Model Name: iPhone 12 Software Version: 18.5 App version: 2025.7.1
Home Assistant: Core: 2025.7.2 Supervisor: 2025.07.1 OS: 16.0
Describe the bug: Whenever I open my iOS app, I see a white screen with a blue ribbon at the top, additionally after reinstalling the app it only asks for permissions and not for a home assistant URL like it should.
To Reproduce: Set the home assistant app to invalid ip address.
Expected behavior: When reinstalling the app I should be asked for a home assistant ip address.
Additional context I have just replaced my home assistant machine, and had to start from scratch due to issues with restoring from backup. Additionally at least one other user has had this exact problem on the home assistant iOS forum recently (https://community.home-assistant.io/t/white-page-iphone/909829/12)
Update to 2025.7.2, pull to refresh, in 5 seconds it will show you an empty state where you can reach companion App settings.
I have the same issue. I have one local server and one remote server, the local one is on 7.2 and the remote on 7.1. All of a sudden I can't connect to any of them, both just show the empty white page. I deleted the app and reinstalled it, no effect, I tried to browse for local servers and it finds my HA server at the correct IP. But when trying to connect it says that there's an error and it can't connect.
I have been running HA for many years with the same settings, servers, and everything. What could be causing this? Something must have changed in an update.
@comatose-tortoise Ok so in which state are you right now? Do you have servers configured in the app or you are stuck in onboarding? If you have servers, please try to remove them, reboot your phone and adding them back.
@bgoncal In my case this was caused by Tailscale doing something to their ip ranges, as far as I can tell. Sorry for bothering you!
@bgoncal In my case this was caused by Tailscale doing something to their ip ranges, as far as I can tell. Sorry for bothering you!
Having the same issue, even with Tailscale app removed, how did you fix it?
@bgoncal In my case this was caused by Tailscale doing something to their ip ranges, as far as I can tell. Sorry for bothering you!
Having the same issue, even with Tailscale app removed, how did you fix it?
Then it’s probably not what had. If I turn Tailscale off it behaves as one would expect.
I've also had this issue occurring on a client's setup where we recently setup tailscale (transitioned from zerotier) for external access. That said it seems to only affect the phone app as using the phone browser works. This issue occurs regardless of whether the VPN is connected or not. Other IOS devices on the local network seem to be unaffected at the moment.
Could having a VPN configuration alone (not connected) be an issue here or does that seem more like a red herring?
I've also had this issue occurring on a client's setup where we recently setup tailscale (transitioned from zerotier) for external access. That said it seems to only affect the phone app as using the phone browser works. This issue occurs regardless of whether the VPN is connected or not. Other IOS devices on the local network seem to be unaffected at the moment.
Could having a VPN configuration alone (not connected) be an issue here or does that seem more like a red herring?
Not sure but something weird is happening for sure, removed any trace of tralescail both from my phone and HA yet i am still unable to use the app
I have an update, I was able to re-setup the app, it connected, gave me the green check and still white screen
So a few things to try:
1 - Update to 2025.7.2 2 - Open companion App settings (if you don't find a way, pull to refresh and wait 5 seconds until you see an empty state) 3 - If you still can't open companion App settings you can Swipe up with 3 fingers. 4 - Then go to "Debugging > Reset frontend cache" 5 - Force close the app and open it again 6 - If nothing made it work, open companion App settings again and remove the server you already have 7 - Reboot your phone 8 - Add the server back in
Always compare to what you can see in iOS Safari at the same moment that something goes wrong inside the App
So a few things to try:
1 - Update to 2025.7.2 2 - Open companion App settings (if you don't find a way, pull to refresh and wait 5 seconds until you see an empty state) 3 - If you still can't open companion App settings you can Swipe up with 3 fingers. 4 - Then go to "Debugging > Reset frontend cache" 5 - Force close the app and open it again 6 - If nothing made it work, open companion App settings again and remove the server you already have 7 - Reboot your phone 8 - Add the server back in
Always compare to what you can see in iOS Safari at the same moment that something goes wrong inside the App
Did all of this already, did not help
@Razer0123 Is it working on iOS Safari? If so, export your companion App logs and submit here https://forms.gle/Uoqz127Phx4mMTpS6
@Razer0123 Is it working on iOS Safari? If so, export your companion App logs and submit here https://forms.gle/Uoqz127Phx4mMTpS6
Yes on Safari it works fine, but I am also able to login from inside the app, but then the page becomes blank
I have just sent the logs
@Razer0123 Your logs are flooded with:
2025-07-24 14:00:03.923 [Info] [main] [Environment.swift:74] init() > WebSocket: disconnecting; permanently: false, error: Optional(HAKit.HAConnectionImpl.ConnectError.noConnectionInfo)
2025-07-24 14:00:03.923 [Error] [main] [HAAPI.swift:93] init(server:urlConfig:) > couldn't create connection info: emptyHostname
Are you in HA Discord? If so, ping me (username: bgoncal2) otherwise send me a screenshot of how is your internal and external URL configured in the companion App settings
@Razer0123 Your logs are flooded with:
2025-07-24 14:00:03.923 [Info] [main] [Environment.swift:74] init() > WebSocket: disconnecting; permanently: false, error: Optional(HAKit.HAConnectionImpl.ConnectError.noConnectionInfo) 2025-07-24 14:00:03.923 [Error] [main] [HAAPI.swift:93] init(server:urlConfig:) > couldn't create connection info: emptyHostnameAre you in HA Discord? If so, ping me (username: bgoncal2) otherwise send me a screenshot of how is your internal and external URL configured in the companion App settings
Sent you a DM on Discord, regarding the screenshot, I am unable to access App settings, all I am able to do is shake to open app debug
For anyone having this problem in the future, delete all server configs by accessing settings doing a 3 finger swipe up, should fix the issue
For anyone having this problem in the future, delete all server configs by accessing settings doing a 3 finger swipe up, should fix the issue
Could you please describe more specifically what you need to do and where? Unfortunately, all the methods I found on the internet haven’t worked for me.
For anyone having this problem in the future, delete all server configs by accessing settings doing a 3 finger swipe up, should fix the issue
Could you please describe more specifically what you need to do and where? Unfortunately, all the methods I found on the internet haven’t worked for me.
Not sure i can make it clearer than I already did, but i will try
Open the app, put 3 fingers on the screen and move them up, a settings window should open
Press the gear icon on the left side, in the top you have servers select all the servers that you have and delete them one by one, when you are done add a new connection
For anyone having this problem in the future, delete all server configs by accessing settings doing a 3 finger swipe up, should fix the issue
Could you please describe more specifically what you need to do and where? Unfortunately, all the methods I found on the internet haven’t worked for me.
Not sure i can make it clearer than I already did, but i will try
Open the app, put 3 fingers on the screen and move them up, a settings window should open
Press the gear icon on the left side, in the top you have servers select all the servers that you have and delete them one by one, when you are done add a new connection
Man, you are a master! I struggled with this for a long time! Thank you for your help!!
This bug appears to persist. After following the directions posted in this issue, now the app won't even connect to the HA's URL.
iOS 26
Latest update from App Store
HA version: 2025.8.3 (snap)
I came across this thread, but none of the suggested solutions worked for me. Here’s what fixed it: I removed my phone’s device from Settings -> Devices & Services -> Mobile App -> three dots at the device, Delete device.
EDIT: it stopped working again next day,
