1# OpenThread CLI - Commissioning
2
3## Overview
4
5Commissioning is the process of adding a new Thread device, called the Joiner, to a Thread network. This process is done under guidance of a [Commissioner](README_COMMISSIONER.md).
6
7## Quick Start
8
9### Form Network
10
11Form a network with the Thread device that has Commissioner support.
12
131. Generate and view new network configuration.
14
15   ```bash
16   > dataset init new
17   Done
18   > dataset
19   Active Timestamp: 1
20   Channel: 13
21   Channel Mask: 0x07fff800
22   Ext PAN ID: d63e8e3e495ebbc3
23   Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
24   Network Key: dfd34f0f05cad978ec4e32b0413038ff
25   Network Name: OpenThread-8f28
26   PAN ID: 0x8f28
27   PSKc: c23a76e98f1a6483639b1ac1271e2e27
28   Security Policy: 0, onrc
29   Done
30   ```
31
322. Commit new dataset to the Active Operational Dataset in non-volatile storage.
33
34   ```bash
35   dataset commit active
36   Done
37   ```
38
393. Enable Thread interface
40
41   ```bash
42   > ifconfig up
43   Done
44   > thread start
45   Done
46   ```
47
48### Obtain Joiner IEEE EUI-64
49
501. Start the Joiner node and obtain the Joiner's IEEE EUI-64.
51
52   ```bash
53   > eui64
54   18b4300000000002
55   Done
56   ```
57
58### Start Commissioner
59
601. Start the Commissioner Role
61
62   ```bash
63   > commissioner start
64   Commissioner: petitioning
65   Done
66   Commissioner: active
67   ```
68
692. Add the Joiner with the device-specific pre-shared key (PSKd)
70
71   ```bash
72   > commissioner joiner add 18b4300000000002 J01NME
73   Done
74   ```
75
76### Start Joiner
77
781. Factory reset the device.
79
80   ```bash
81   > factoryreset
82   ```
83
842. Start the Joiner process.
85
86   ```bash
87   > ifconfig up
88   Done
89   > joiner start J01NME
90   Done
91   Join success
92   ```
93
943. Attach to Thread network
95
96   ```bash
97   > thread start
98   Done
99   ```
100
1014. After successful attach, validate the device has the same Active Operational Dataset as above.
102
103   ```bash
104   > dataset active
105   Active Timestamp: 1
106   Channel: 13
107   Channel Mask: 0x07fff800
108   Ext PAN ID: d63e8e3e495ebbc3
109   Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
110   Network Key: dfd34f0f05cad978ec4e32b0413038ff
111   Network Name: OpenThread-8f28
112   PAN ID: 0x8f28
113   PSKc: c23a76e98f1a6483639b1ac1271e2e27
114   Security Policy: 0, onrc
115   Done
116   ```
117
118## CLI Reference
119
120- [Commissioner CLI Reference](README_COMMISSIONER.md)
121- [Joiner CLI Reference](README_JOINER.md)
122