Skip to content

Installation

Ben edited this page Jul 19, 2026 · 1 revision

1. Install

Homebridge UI

Simply go to the 'Plugins' page, search Cloudflared and install the @homebridge-plugins/homebridge-cloudflared-tunnel plugin.

Manually

This will only work if you are using a platform which installs plugins globally.

sudo npm i -g @homebridge-plugins/homebridge-cloudflared-tunnel

2. Configure

If you use the Homebridge UI then a configuration screen will appear after installing the plugin where you can configure the tunnel and accept the Cloudflare notice.

  1. Enable Auto Start Tunnel in the plugin settings.
  2. Restart Homebridge - the tunnel URL will be displayed in the logs.
  3. Optionally set your own domain, token, protocol, hostname and port in the plugin settings for a permanent tunnel.

See the Configuration page for JSON configuration templates and other optional settings if editing the configuration manually.

3. Restart

And voila, your tunnel should start and expose your chosen local service.

Clone this wiki locally