Troubleshooting

This page provides solutions to common issues you might encounter.

Common Issues

Plugin Does Not Appear in Homebridge

• Solution: Ensure the plugin is installed globally using npm install -g homebridge-ws-olarm-plugin.

Authentication Failed

• Cause: Incorrect userEmailPhone or userPass in the configuration.
• Solution: Verify your Olarm credentials and update the config.json file.

Accessories Not Showing in Home App

• Cause: Misconfiguration or plugin initialization failure.
• Solution:
  • Check the Homebridge logs for errors.
  • Ensure the plugin is correctly configured and Homebridge has been restarted.

MQTT Connection Issues

• Cause: Network issues or incorrect tokens.
• Solution:
  • Verify your network connection.
  • Check the logs for MQTT errors.
  • Ensure your access token is valid.

Getting Help

• Logs: Check the Homebridge logs for detailed error messages.
• GitHub Issues: Report issues on the GitHub repository.

Debugging Tips

• Enable debug logging by starting Homebridge with the -D flag:

  homebridge -D

Check for error messages related to authentication, MQTT connections, or accessory registration.

Updating the Plugin

• To update the plugin to the latest version:

  npm update -g homebridge-ws-olarm-plugin

• Restart Homebridge after updating.

Reinstalling the Plugin

• Uninstall the plugin:

  npm uninstall -g homebridge-ws-olarm-plugin

• Reinstall the plugin:

  npm install -g homebridge-ws-olarm-plugin