diff --git a/storage/volumes.md b/storage/volumes.md index 58060b651c..b3472f7680 100644 --- a/storage/volumes.md +++ b/storage/volumes.md @@ -447,6 +447,26 @@ $ docker run -d \ nginx:latest ``` +### Create a service which creates an NFS volume + +This example shows how you can create an NFS volume when creating a service. This example uses `10.0.0.10` as the NFS server and `/var/docker-nfs` as the exported directory on the NFS server. Note that the volume driver specified is `local`. + +#### NFSv3 +```bash +$ docker service create -d \ + --name nfs-service \ + --mount 'type=volume,source=nfsvolume,target=/app,volume-driver=local,volume-opt=type=nfs,volume-opt=device=:/var/docker-nfs,volume-opt=o=addr=10.0.0.10' \ + nginx:latest +``` + +#### NFSv4 +```bash +docker service create -d \ + --name nfs-service \ + --mount 'type=volume,source=nfsvolume,target=/app,volume-driver=local,volume-opt=type=nfs,volume-opt=device=:/,"volume-opt=o=10.0.0.10,rw,nfsvers=4,async"' \ + nginx:latest` +``` + ## Backup, restore, or migrate data volumes Volumes are useful for backups, restores, and migrations. Use the