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)

[bgoncal]

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.

[comatose-tortoise]

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.

[bgoncal]

@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.

[comatose-tortoise]

@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!

[Razer0123]

@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?

[comatose-tortoise]

@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.

[cchaz003]

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?

[Razer0123]

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

[Razer0123]

I have an update, I was able to re-setup the app, it connected, gave me the green check and still white screen

[bgoncal]

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

[Razer0123]

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