Set up an OpenThread Border Router (OTBR) on a Raspberry Pi using the Docker install method and form a Thread network

domain: openthread.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Flash a Radio Co-Processor (RCP) firmware onto a compatible IEEE 802.15.4 USB dongle (e.g., Nordic nRF52840) and connect it to the Raspberry Pi
  2. Pull and run the OTBR Docker image, passing the RCP serial device path via the --radio-url flag (e.g., spinel+hdlc+uart:///dev/ttyACM0)
  3. Open the OTBR web GUI (default port 80) and use the Form Network page to generate a new Thread network dataset (PAN ID, channel, network key, Extended PAN ID)
  4. Verify the Thread interface is up with ot-ctl state; confirm the node reaches the Leader or Router role
  5. Enable border routing so that Thread devices obtain routable IPv6 addresses and can communicate with the LAN; check that the off-mesh route is advertised via ot-ctl route
  6. Test end-to-end connectivity by pinging a Thread end-device's mesh-local address from a LAN host through the border router

Known gotchas

Related routes

flash openthread rcp (radio co-processor) firmware onto a thread radio for use with a border router
openthread.io · 5 steps · unrated
share thread network credentials across multiple border routers so they act as redundant paths on one network
openthread.io · 5 steps · unrated
Commission a Matter-over-Thread device using chip-tool and an operational Thread dataset from OTBR
project-chip.github.io · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans