selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
hass-otbr-docker logo

Self-host hass-otbr-docker

v0.4.0

Stand-alone OpenThread Border Router for Home Assistant

BetaOpen Source
Updated9 hours ago
LanguageShell
Setup difficultyAdvanced
Stars
174
Ports
8081 (REST API used by Home Assistant), 7586 (Web UI)
Docker
ghcr.io/ownbee/hass-otbr-docker
Install with Docker Compose

What is hass-otbr-docker?

A Docker image that runs the OpenThread Border Router as a standalone service. It exposes a REST API and optional web interface so Home Assistant can manage Thread and Matter devices without needing Yellow or HassOS. You need a Thread radio such as the Connect ZBT-1 and IPv6 enabled on the host. The container works with Home Assistant's Thread, Matter, and Open Thread Border Router integrations. It is derived from the official add-on but strips out the bashio layer for independent operation.

Should you self-host hass-otbr-docker?

hass-otbr-docker scores 38/100 on selfhost.directory (how scoring works) and ranks #90 of 104 in Home Automation. It has 174 GitHub stars.

It shipped 3 stable releases in the past year. The latest, v0.4.0, came out on 13 October 2026. New versions land roughly every 5 months.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is written mostly in Shell.

Its closest alternative on selfhost.directory is Home Assistant (91/100, 91 789 stars). It scores higher overall, so compare the two before you pick. See hass-otbr-docker vs Home Assistant side by side.

Features

  • Auto Firmware Flashing
  • Firewall
  • NAT64 Support
  • Network-based RCP SupportMarked as NOT TESTED in documentation
  • OpenThread Border Router
  • REST API
  • Thread 1.4+ Beta Support
  • Web UI

hass-otbr-docker README

How to install hass-otbr-docker

Install hass-otbr-docker with Docker Compose

Environment variables
DEVICE, BACKBONE_IF, FLOW_CONTROL, FIREWALL, NAT64, BAUDRATE, OTBR_REST_PORT, OTBR_WEB_PORT, OTBR_WEB_INTERFACE, AUTOFLASH_FIRMWARE, OTBR_LOG_LEVEL

services: otbr: container_name: otbr image: ghcr.io/ownbee/hass-otbr-docker restart: unless-stopped privileged: true # don't change this ! network_mode: host # don't change this ! cap_add: - SYS_ADMIN - NET_ADMIN environment: DEVICE: "/dev/ttyUSB1" BACKBONE_IF: enp3s0 FLOW_CONTROL: 1 FIREWALL: 1 NAT64: 1 BAUDRATE: 460800 OTBR_REST_PORT: 8081 OTBR_WEB_PORT: 7586 # OTBR_WEB_INTERFACE: "0.0.0.0" AUTOFLASH_FIRMWARE: 0 OTBR_LOG_LEVEL: error devices: - /dev/ttyUSB1:/dev/ttyUSB1 - /dev/net/tun:/dev/net/tun volumes: - ./otbr_data:/data/thread logging: driver: "json-file" options: max-file: "3" max-size: "1m"

Requires privileged mode, host networking, and specific capabilities (SYS_ADMIN, NET_ADMIN). Needs a Thread radio device (e.g., /dev/ttyUSB1) and host network interface (BACKBONE_IF).

hass-otbr-docker releases & version history

More in Network

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…