Skip to content

Commit bf02c57

Browse files
Merge pull request #296638 from PatAltimore/patricka-docker-mounts
Add docker mount clarification
2 parents 30feb07 + 62c6317 commit bf02c57

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

articles/iot-edge/how-to-access-host-storage-from-module.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Use environment variables and create options to enable module acces
44
author: PatAltimore
55

66
ms.author: patricka
7-
ms.date: 06/10/2024
7+
ms.date: 03/19/2025
88
ms.topic: concept-article
99
ms.service: azure-iot-edge
1010
services: iot-edge
@@ -19,7 +19,7 @@ IoT Edge modules can use storage on the host IoT Edge device itself for improved
1919

2020
## Configure system modules to use persistent storage
2121

22-
By default, IoT Edge system modules, IoT Edge agent and IoT Edge hub, store state in the ephemeral file system of their container instance. This state is lost when the container instance is recycled, for example, when module image version or createOptions is updated.
22+
By default, IoT Edge system modules, IoT Edge agent, and IoT Edge hub, store state in the ephemeral file system of their container instance. This state is lost when the container instance is recycled, for example, when module image version or createOptions is updated.
2323

2424
For production scenarios, use a persistent storage location on the host filesystem to store system module state. Doing so improves solution robustness and cloud message delivery guarantees.
2525

@@ -80,13 +80,18 @@ Your deployment manifest would be similar to the following:
8080
On version 1.4 and newer, there's no need for manually setting ownership or permissions for host storage backing the `StorageFolder`. Permissions and ownership are automatically managed by the system modules during startup.
8181

8282
> [!NOTE]
83-
> Automatic permission management of host bound storage only applies to system modules, IoT Edge agent and Edge hub. For custom modules, manual management of permissions and ownership of bound host storage is required if the custom module container isn't running as `root` user.
83+
> Automatic permission management of host bound storage only applies to system modules, IoT Edge agent, and Edge hub. For custom modules, manual management of permissions and ownership of bound host storage is required if the custom module container isn't running as `root` user.
8484
8585

8686

8787
## Link module storage to device storage for custom modules
8888

89-
If your custom module requires access to persistent storage on the host file system, use the module's create options to bind a storage folder in module container to a folder on the host machine. For example:
89+
If your custom module requires access to persistent storage on the host file system, use the module's create options to bind a storage folder in module container to a folder on the host machine.
90+
91+
You can use a bind mount or a volume mount. A bind mount allows you to specify a host directory to be mounted into the module container. A volume mount allows you to specify a volume that is managed by Docker. For more information about when to use bind mounts or volume mounts, see the Docker documentation for [volume mounts](https://docs.docker.com/engine/storage/volumes) and [bind mounts](https://docs.docker.com/storage/bind-mounts).
92+
93+
The following example shows how to use a bind mount in the module's create options:
94+
9095

9196
```json
9297
{

0 commit comments

Comments
 (0)