Install

Install Home Assistant Bridge from the timmo pacman repository, a Debian or RPM package, or a release archive.

Home Assistant Bridge is a single Linux binary for x86_64 and aarch64. Every package includes the binary, the ha-bridge.service user service and shell completions for bash, zsh and fish.

Arch Linux

Packages are published to the unofficial timmo pacman repository. Add it before the other repository sections in /etc/pacman.conf:

[timmo]
SigLevel = PackageRequired DatabaseOptional TrustedOnly
Server = https://packages.timmo.dev/$arch

Then install one of the two packages:

sudo pacman -Syu ha-bridge-bin

The packages conflict with each other, so installing one replaces the other.

The install hook enables ha-bridge.service for every user’s future logins. If you install with sudo from a running desktop session, it also starts the service for you. On upgrade it restarts the service only if it was already running, so a service you stopped stays stopped.

Debian, Ubuntu and Fedora

Each GitHub release has .deb and .rpm packages:

# Debian and Ubuntu
sudo apt install ./ha-bridge_<version>_amd64.deb

# Fedora
sudo dnf install ./ha-bridge-<version>-1.x86_64.rpm

These install the user service but don’t enable it. See Running the bridge.

Release archive

Each release also has a ha-bridge-<version>-linux-<arch>.tar.gz archive with just the binary. Put it somewhere on your PATH:

tar -xzf ha-bridge-<version>-linux-x86_64.tar.gz
install -Dm755 ha-bridge ~/.local/bin/ha-bridge

Release assets come with a SHA256SUMS file and a Sigstore bundle. To check an asset was built by this repository’s release workflow:

gh attestation verify ha-bridge-<version>-linux-x86_64.tar.gz --repo timmo001/ha-bridge

Build from source

You need mise, which installs the pinned Bun and Node versions:

git clone https://github.com/timmo001/ha-bridge.git
cd ha-bridge
mise install
mise run build

The binary is written to dist/ha-bridge.

Next steps

• Configure your Home Assistant URL and token.
• Run the bridge as a user service.