{"id":37767457,"url":"https://github.com/ownbee/hass-otbr-docker","last_synced_at":"2026-01-16T14:46:19.754Z","repository":{"id":267342383,"uuid":"900860297","full_name":"ownbee/hass-otbr-docker","owner":"ownbee","description":"Stand-alone Home Assistant OpenThread Border Router docker container.","archived":false,"fork":false,"pushed_at":"2025-05-28T07:19:41.000Z","size":98,"stargazers_count":25,"open_issues_count":1,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-28T08:27:27.285Z","etag":null,"topics":["docker","home-assistant","otbr"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ownbee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-09T15:51:13.000Z","updated_at":"2025-05-28T07:19:45.000Z","dependencies_parsed_at":"2024-12-09T20:24:49.618Z","dependency_job_id":"8f02be08-8a45-4470-8f59-31f329f8ce71","html_url":"https://github.com/ownbee/hass-otbr-docker","commit_stats":null,"previous_names":["ownbee/hass-otbr-docker"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ownbee/hass-otbr-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ownbee%2Fhass-otbr-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ownbee%2Fhass-otbr-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ownbee%2Fhass-otbr-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ownbee%2Fhass-otbr-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ownbee","download_url":"https://codeload.github.com/ownbee/hass-otbr-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ownbee%2Fhass-otbr-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","home-assistant","otbr"],"created_at":"2026-01-16T14:46:19.188Z","updated_at":"2026-01-16T14:46:19.741Z","avatar_url":"https://github.com/ownbee.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Home Assistant: Docker OpenThread Border Router\n\nStand-alone Home Assistant OpenThread Border Router docker container. For containerized home\nassistance setup without Yellow or HassOS.\n\nThis is a docker container based on the Home Assistant OpenThread Border Router add-on\n(https://github.com/home-assistant/addons/tree/master/openthread_border_router) to get the patches\nand quirks that the hass team has made. It is the same without the bashio stuff that communicates\nwith home assistance instance in some way. Just to make the container work stand-alone.\n\nTested with [Home Assistant Connect ZBT-1](https://www.home-assistant.io/connectzbt1/). Only tested\nwith Aqara U200 Lock as it is the only Thread device I've got so far.\n\n\nDisclaimer: I am completely new to IPv6 and Thread so I don't fully know what I am doing here. Just\nread documentation and forum threads and eventually got it working using this setup.\n\n## Prerequisite\n\n1. It did not work until I turned on IPv6 on my LAN (without ISP involved). I use Unifi networking\n   hardware so I enabled static IPv6 in the Unifi Controller for the Default network:\n    * Used https://unique-local-ipv6.com/# for generating a local IPv6 subnet and added \":0001\" as\n      gateway address. For example: `fda1:1c14:16ac:0001::/64` (starting `fd` means local).\n    * Configured SLAAC and enabled IPv6 DNS server.\n    * IPv6 on WAN interface disabled.\n    * Also enabled mDNS and IGMP snooping on the Default network.\n2. Configured the docker host with the following sysctl:\n\n    ```\n    net.ipv6.conf.all.disable_ipv6 = 0\n    net.ipv4.conf.all.forwarding = 1\n    net.ipv6.conf.all.forwarding = 1\n    net.ipv6.conf.all.accept_ra_rt_info_max_plen = 64\n    net.ipv6.conf.all.accept_ra = 2\n    ```\n3. Flash the OpenThreadRCP firmware on the Home Assistant Connect ZBT-1 stick. I used the python\n   flasher and the latest v2.4.0.0 firmware.\n\n    * Firmware repo: https://github.com/NabuCasa/silabs-firmware\n    * Python flasher: https://github.com/NabuCasa/universal-silabs-flasher\n\n\n## Setup\n\n1. Start this `ghcr.io/ownbee/hass-otbr-docker` container, see the docker-compose file and modify the environment variables\n   according to you environment. The env variables are mapped from the addon config to these env\n   variables:\n\n    | ENV VARIABLE       | Description                                            |\n    |--------------------|--------------------------------------------------------|\n    | DEVICE             | Serial port where the OpenThread RCP Radio is attached |\n    | BAUDRATE           | Serial port baudrate (depends on firmware)   |\n    | FLOW_CONTROL (1 or 0) | If hardware flow control should be enabled (depends on firmware) |\n    | AUTOFLASH_FIRMWARE (1 or 0) | Automatically install/update firmware (Home Assistant SkyConnect/Yellow) |\n    | OTBR_LOG_LEVEL     | Set the log level of the OpenThread BorderRouter Agent (info)    |\n    | OTBR_REST_PORT     | Port for REST API used by home assistant |\n    | OTBR_WEB_PORT      | Port for WEB UI |\n    | OTBR_WEB (1 or 0)  | Enable or disable WEB UI |\n    | FIREWALL (1 or 0)  | Enable OpenThread Border Router firewall to block unnecessary traffic |\n    | NAT64 (1 or 0)     | Enable NAT64 to allow Thread devices accessing IPv4 addresses |\n    | NETWORK_DEVICE     | IP address and port to connect to a network-based RCP (NOT TESTED) |\n    | BACKBONE_IF        | Host network interface to use (e.g. eth0, wlan0, enp3s0) |\n\n2. Install the `Open Thread Border Router`, `Thread` and `Matter` integrations in your home assistance instance.\n\n3. Integrations -\u003e Open Thread Border Router, and add your border router container that you just\n   started. I used \"http://\u003cHOST_IP\u003e:8081\".\n\n4. Go to Integrations -\u003e Thread -\u003e Configure and add the OTBR network, it should pop-up after the\n   last step. Click \"Make as preferred\", \"Reset Border router\" and Enable Android/IOS commissioning.\n\n5. You might have to go to https://\u003cYOUR_HASS_URL\u003e`/config/matter/dashboard` and \"SET THREAD\n   CREDENTIALS\" to the dataset found with clicking the \"i\" in your Thread integration. Unclear if\n   this is needed.\n\n5. On you Android Phone, go to Settings -\u003e App -\u003e Troubleshooting and click on Sync Thread Auth.\n\n6. Pair a Thread device by scanning the Matter QR-Code with Integrations -\u003e Add Matter device -\u003e New device.\n\n7. The Android based commissioning/pairing took roughly 2-3 minutes but succeeded eventually.\n\nAlso see the following documentation for further information:\n\n* https://openthread.io/guides/border-router/docker\n* https://github.com/home-assistant/addons/tree/master/openthread_border_router\n* https://www.home-assistant.io/integrations/matter\n* https://www.home-assistant.io/integrations/thread\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fownbee%2Fhass-otbr-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fownbee%2Fhass-otbr-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fownbee%2Fhass-otbr-docker/lists"}