Tethral × Homebridge installer

One command. Sets up Homebridge + the @tethralinc/homebridge-tethral plugin.

Linux, macOS, Raspberry Pi, WSL2

curl-to-shell

curl -fsSL https://get.tethral.ai/hb | sh

Windows 11

Elevated PowerShell (right-click → Run as administrator)

iwr -useb https://get.tethral.ai/hb.ps1 | iex

What it does

Detects your OS
Installs Node 22 and Homebridge if missing (via the official Homebridge install scripts)
Installs the @tethralinc/homebridge-tethral npm package
Restarts Homebridge so the new plugin is loaded
Prints the Homebridge UI URL where you finish setup (paste API token, pair iPhone)

The Tethral API token is configured in the Homebridge UI after install, not in the script — so no secrets pass through the shell pipe.

Don't trust curl-to-shell?

Reasonable. Read the scripts first:

Bash source: hb
PowerShell source: hb.ps1

Or download and inspect locally before running:

curl -fsSL https://get.tethral.ai/hb -o hb
less hb
sh hb

Prefer to install Homebridge yourself?

Skip the installer entirely. Install Homebridge using the canonical method for your platform, then search the Homebridge UI's Plugins tab for @tethralinc/homebridge-tethral. Per-platform guides: