Common Errors

Here are some of the common problems you may experience with the plugin and how to resolve them.

Login/Startup Errors

If the plugin cannot start or log in:

• Check the Cloudflare notice is accepted in the settings and the local service the tunnel points at is running
• The log usually contains the exact reason - enable debug mode (Homebridge UI → Settings → Log Settings → debug level) and restart for more detail

Devices Not Appearing or Not Responding

• Restart Homebridge after any configuration change
• Check the device works in its own manufacturer app first - the plugin can only see what the account sees

Getting More Help

• Search the existing issues - someone may have had the same problem
• If not, please open a support request and include your Homebridge log