The sign in page does not come back to Home Assistant
The sign in returns through My Home Assistant
(my.home-assistant.io/redirect/oauth). Turn on My Home Assistant under
Settings, System, General (it is on by default), then add the
integration again. Returning straight to your own Home Assistant address is not
supported.
“Every instance on your plan is in use”
Your plan’s instances are all taken. Revoke one you no longer use on the Home Assistant card, or add a Top-up for another instance, then sign in again.
“Home Assistant needs the Supporter plan”
The account is on the Free plan. Upgrade at /pricing/, then add the integration again.
A re-authenticate prompt after it was working
The instance was revoked, or the Supporter plan ended. Open the integration and sign in again. If the plan ended, renew it on the pricing page first.
Marked Deactivated on the card
Your plan now allows fewer instances than you have, so the newest ones were turned off. Revoke one you do not need, or add a Top-up, and sign in again from the deactivated Home Assistant.
No devices after setup
The account has no saved places yet. Add one on wxalerts.org and its device appears within a few seconds, with no restart.
Alert entities unavailable for one place
The place has no US county, because it is offshore or outside the US. Its storm cell entities still work.
Storm cell entities unavailable
Look at sensor.wxalerts_feed_age and binary_sensor.wxalerts_connected on
the WxAlerts device.
- Connected is off. Home Assistant cannot reach the broker. Check that it
can reach
mqtt.wxalerts.orgon port 443. A firewall that allows HTTPS but blocks WebSocket upgrades is the usual cause. - Connected is on, feed age is climbing. The WxAlerts server has not reported in. The storm cell entities turn unavailable after 15 minutes and come back on their own when it does. Check status.
Unavailable never means the sky is clear.
An automation did not fire after a restart
Events do not fire for alerts or storm cells already in effect when Home Assistant starts, so a restart never announces a warning twice. The entities are correct. Trigger on the entity state if you need to catch those too.
Some counties have no alerts
The broker allows 20 subscriptions per client, which covers 17 distinct counties. A warning in the Home Assistant log says how many were left out.
Diagnostics and debug logs
On the integration page, open the menu and choose Download diagnostics. The username, password and place coordinates are removed.
For more detail, turn on debug logging, restart and reproduce the problem:
logger:
default: warning
logs:
custom_components.wxalerts: debugReport problems at github.com/wxalerts/WxAlerts-HA with the Home Assistant version, the integration version and the log.