From 272f0dbb958724dbd3dcdf1aa9d2013dfad6ed07 Mon Sep 17 00:00:00 2001 From: Misty Stanley-Jones Date: Wed, 13 Sep 2017 10:13:02 -0700 Subject: [PATCH] Put back info on --storage-driver and caveats (#4604) --- engine/userguide/storagedriver/selectadriver.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/engine/userguide/storagedriver/selectadriver.md b/engine/userguide/storagedriver/selectadriver.md index 2554d780b7..9f9ea5ed94 100644 --- a/engine/userguide/storagedriver/selectadriver.md +++ b/engine/userguide/storagedriver/selectadriver.md @@ -215,10 +215,21 @@ Storage Driver: overlay ``` -To set the storage driver, set the option in the `daemon.json` + + +To set the storage driver, you can use the `--storage-driver` flag when starting +the Docker daemon manually, or (recommended) set the option in the `daemon.json` file, which is located in `/etc/docker/` on Linux and -`C:\ProgramData\docker\config\` on Windows Server. Changing the storage driver -on Docker for Mac or Docker for Windows is not supported. +`C:\ProgramData\docker\config\` on Windows Server. + +> **Note**: Using the `--storage-driver` flag when running `dockerd` manually or +> using an init script is not recommended. We recommend setting the option in +> the `daemon.json` file instead, because this mechanism is cross-platform, +> and will not create configuration conflicts with the default init scripts for +> your operating system. + +Changing the storage driver on Docker for Mac or Docker for Windows is not +supported. If the `daemon.json` file does not exist, create it. Assuming there are no other settings in the file, it should have the following contents: