Join the Thread Network

View source on GitHub

After externally commissioning a device using the OT Commissioner CLI, a Joiner is ready to join the Thread network.

Join the network

On the Joiner device, start the Thread protocol to automatically join the network.

thread start

Check the state after a few moments to confirm. It may initially start as a child, but within two minutes it should upgrade to a router.


Also check the device's IPv6 addresses. It should have a Global address using the On-Mesh Prefix specified during formation of the Thread network through the OTBR Web GUI.

fd11:22:0:0:3a15:3211:2723:dbe1 #Global address with on-mesh prefix

Ping the external internet

Test the connectivity between the Joiner device in the Thread network and the external internet by pinging a public IPv4 address.

For example, the Well-Known NAT64 prefix of 64:ff9b::/96 and an IPv4 address of combine to form an IPv6 address of 64:ff9b::808:808.

Add an external route for the NAT64 Prefix:

sudo ot-ctl route add 64:ff9b::/96 s med
sudo ot-ctl netdata register

Ping the synthesized IPv6 address 64:ff9b::808:808 from the OpenThread CLI on the Joiner device:

ping 64:ff9b::808:808
16 bytes from 64:ff9b:0:0:0:0:808:808: icmp_seq=3 hlim=45 time=72ms