@homebridge-plugins/homebridge-cloudflared-tunnel

Plugin Information

• This plugin runs a Cloudflare Tunnel so you can access your Homebridge instance remotely. The plugin:
  • starts and supervises a cloudflared tunnel process alongside Homebridge
  • shows the tunnel status in HomeKit as a sensor accessory
  • can use a free quick tunnel (random URL) or your own Cloudflare domain

Prerequisites

• To use this plugin, you will need to already have:
  • Node: latest version of v22 or v24 - any other major version is not supported.
  • Homebridge: v2 - refer to link for more information and installation instructions.

Setup

• Installation
• Configuration
• Beta Version
• Node Version

Features

• Matter support is available when running Homebridge v2.0+ with Matter enabled:
  • enableMatter: true (the default) uses Matter mode when the Matter runtime is available; the tunnel status is published as a Matter motion sensor endpoint.
  • enableMatter: false forces HAP mode; the tunnel status is published as a HomeKit occupancy sensor.
  • Tunnel behaviour is identical in both modes, and the plugin falls back to HAP automatically if Matter is unavailable.

Help/About

• Common Errors
• Support Request
• Changelog
• About Me

Credits

• To @donavanbecker: the original creator and maintainer of this plugin.
• To the creators/contributors of Homebridge who make this plugin possible.

Disclaimer

• I am in no way affiliated with Cloudflare and this plugin is a personal project that I maintain in my free time.
• Use this plugin entirely at your own risk - please see licence for more information.