You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-edge/configure-device.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,15 +11,17 @@ services: iot-edge
11
11
12
12
# Configure IoT Edge device settings
13
13
14
-
This article shows settings and options for configuring the IoT Edge *config.toml* file found in the `/etc/aziot` directory on an IoT Edge device. IoT Edge uses the *config.toml* file to initialize settings for the device. Each of the sections of the `config.toml` file has several options. Not all options are mandatory, as they apply to specific scenarios.
14
+
This article shows settings and options for configuring the IoT Edge *config.toml* file of an IoT Edge device. IoT Edge uses the *config.toml* file to initialize settings for the device. Each of the sections of the `config.toml` file has several options. Not all options are mandatory, as they apply to specific scenarios.
15
15
16
-
A template containing all options can be found in the *config.toml.template* file within the `/etc/aziot` directory on an IoT Edge device.
16
+
## Configuration template
17
17
18
-
> [!IMPORTANT]
19
-
> The hostname, parent_hostname, and trust_bundle_cert parameters, must be at the beginning of the configuration file before any sections. Adding the parameter before defined sections, ensures it's applied correctly.
20
-
>
18
+
A template containing all options can be found in the *config.toml.template* file within the `/etc/aziot` directory on an IoT Edge device. You can copy the contents of the template over to your *config.toml* file and uncomment the sections you need.
19
+
20
+
### Top of the config.toml file
21
+
22
+
The `hostname`, `parent_hostname`, and `trust_bundle_cert` parameters must be at the beginning of the configuration file before any other sections. Adding parameters before defined sections ensures they are applied correctly.
21
23
22
-
## Hostname
24
+
###Hostname
23
25
24
26
To enable gateway discovery, every IoT Edge gateway (parent) device needs to specify a hostname parameter that its child devices use to find it on the local network.
25
27
@@ -29,7 +31,7 @@ For the **hostname**, replace **my-device** with your device name to override th
29
31
hostname = "my-device"
30
32
```
31
33
32
-
## Parent hostname
34
+
###Parent hostname
33
35
34
36
Parent hostname is used when the IoT Edge device is nested. Every downstream IoT Edge device needs to specify a **parent_hostname** parameter to identify its parent. In a hierarchical scenario where a single IoT Edge device is both a parent and a child device, it needs both parameters.
For more information about the IoT Edge trust bundle, see [Manage trusted root CA](how-to-manage-device-certificates.md#manage-trusted-root-ca-trust-bundle).
53
55
54
-
## Elevated Docker Permissions Flag
56
+
###Elevated Docker Permissions Flag
55
57
56
58
Some docker capabilities can be used to gain root access. By default, the **--privileged** flag and all capabilities listed in the **CapAdd** parameter of the docker **HostConfig** are allowed.
0 commit comments