OpenThreadBorderRouter-HA

OpenThreadBorderRouter-HA

Docker-Anwendung from pureelectricity's Repository

Übersicht

OpenThread Border Router (Home Assistant Optimized) This container runs an OpenThread Border Router (OTBR) specifically tweaked for integration with Home Assistant via the Silicon Labs EFR32MG21 chipset (SkyConnect, ZBT-1, Sonoff ZBDongle-E). CRITICAL PREREQUISITES - READ BEFORE INSTALLING: 1. Enable IPv6 in Unraid: Navigate to Settings > Network Settings. Ensure "Network Protocol" is set to IPv4 + IPv6. If this is disabled, Thread networking will not function. 2. Host Kernel Configuration (Persistence Required): Unraid resets network forwarding rules on every reboot. You must apply the following commands on the Unraid Host to prevent the Thread network from breaking. Commands to run: [code] sysctl -w net.ipv6.conf.all.forwarding=1 sysctl -w net.ipv6.conf.br0.accept_ra=2 sysctl -w net.ipv6.conf.eth0.accept_ra=2 [/code] How to automate this (Choose one): Option A: User Scripts Plugin (Recommended) Install the "User Scripts" plugin. Create a new script with the commands above and set it to run "At Startup of Array". Option B: The Go File (Native) Edit the file /boot/config/go on your flash drive and add the commands to the bottom of the file. This will execute them during the boot sequence. 3. USB Firmware: Your USB stick MUST be flashed with OpenThread RCP Firmware at 460800 baud. (Multiprotocol firmware is not supported). Configuration Notes: - Network Type: Must be Host for mDNS discovery. - WebUI Port: Default is 8099 (to avoid conflict with Unraid Port 80).

Laufzeit-Argumente

Web-UI
http://[IP]:[PORT:8099]/
Netzwerk
host
Shell
bash
Privilegiert
true
Extra Params
--cap-add=SYS_ADMIN --cap-add=NET_ADMIN --sysctl "net.ipv6.conf.all.disable_ipv6=0" --sysctl "net.ipv4.conf.all.forwarding=1" --sysctl "net.ipv6.conf.all.forwarding=1"

Konfiguration der Vorlage

Radio Device (Passthrough)Devicerw

Map your physical USB stick here (use /dev/serial/by-id/...). It maps to /dev/ttyUSB0 inside the container.

Ziel
/dev/ttyUSB0
Standard
/dev/serial/by-id/YOUR_DEVICE_HERE
Radio Path (Internal)Variable

The internal path to the radio. Leave this as /dev/ttyUSB0 matching the internal side of the device mapping above.

Ziel
DEVICE
Standard
/dev/ttyUSB0
Wert
/dev/ttyUSB0
BaudrateVariable

Baudrate for RCP Firmware. SkyConnect/ZBT-1/Sonoff-E usually use 460800.

Ziel
BAUDRATE
Standard
460800
Wert
460800
Flow ControlVariable

Hardware Flow Control. Set to 1 for SkyConnect/ZBT-1. Set to 0 if using a generic stick without flow control support.

Ziel
FLOW_CONTROL
Standard
1
Wert
1
Backbone InterfaceVariable

The Unraid Host interface connected to your LAN/Internet. Usually br0 or eth0.

Ziel
BACKBONE_IF
Standard
br0
Wert
br0
OTBR WebUI PortVariable

Port for the OTBR Web Interface. Changed from default 80 to prevent conflict with Unraid.

Ziel
OTBR_WEB_PORT
Standard
8099
Wert
8099
OTBR REST PortVariable

Port for the REST API (Used by Home Assistant).

Ziel
OTBR_REST_PORT
Standard
8081
Wert
8081
Enable NAT64Variable

Enable NAT64 translation.

Ziel
NAT64
Standard
1
Wert
1
Enable FirewallVariable

Enable internal firewall.

Ziel
FIREWALL
Standard
1
Wert
1
Data StoragePathrw

Persistent storage for Thread credentials and dataset.

Ziel
/data/thread
Standard
/mnt/user/appdata/otbr
TUN AdapterDevicerw

Required for creating the wpan0 network interface.

Ziel
/dev/net/tun
Standard
/dev/net/tun
Wert
/dev/net/tun
Local TimePathro

Sync time with host.

Ziel
/etc/localtime
Standard
/etc/localtime
Wert
/etc/localtime
Auto-Flash FirmwareVariable

Disable automatic firmware flashing attempts.

Ziel
AUTOFLASH_FIRMWARE
Standard
0
Wert
0
Log LevelVariable

Log verbosity (info, debug, warn).

Ziel
OTBR_LOG_LEVEL
Standard
info
Wert
info

Einzelheiten

Repository
ghcr.io/ownbee/hass-otbr-docker:latest
Zuletzt aktualisiert2026-05-31
Erstmals gesehen2025-12-15

Führen Sie OpenThreadBorderRouter-HA auf Unraid aus.

OpenThreadBorderRouter-HA ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.