Remote connection problems? Check this

## Supported Remote Connection Configurations (iOS App)

The iOS app currently supports the following remote connection configurations:

- **Home Assistant Cloud**
- **Exposing your local IP to the internet** (e.g., DuckDNS or any other DDNS)
- **VPN**\*

\* _VPN support depends on how it is configured. For example, background operations such as Siri Shortcuts or widgets displaying states will fail if the VPN is not active when triggered._

---

## Important Notes

The iOS app does **not guarantee full functionality** when using tunneling services like **Cloudflare**. While it may work in many cases, the app cannot account for errors caused by security rules or restrictions set by you or by Cloudflare itself.

---

## Unsupported Scenarios

The app **will not work** in the following scenarios:

- Any form of secondary authentication between the remote connection and Home Assistant (e.g., Google login, PIN code)
- Remote connections with **location-based or unpredictable access restrictions**
- Servers using **self-signed SSL certificates**

---

## Why Certain Scenarios Aren’t Supported

Please understand that some scenarios above are unsupported not out of unwillingness, but due to the **added complexity required to maintain them**. The iOS app is more than just a frontend—it performs many background operations. Each additional authentication layer significantly increases development and maintenance effort, and at the moment, we do not have the bandwidth to support all edge cases.