Signed-off-by: Neil Peterson <neilpeterson@outlook.com>
| ... | ... |
@@ -975,19 +975,23 @@ the `--cgroup-parent` option on the daemon. |
| 975 | 975 |
The `--config-file` option allows you to set any configuration option |
| 976 | 976 |
for the daemon in a JSON format. This file uses the same flag names as keys, |
| 977 | 977 |
except for flags that allow several entries, where it uses the plural |
| 978 |
-of the flag name, e.g., `labels` for the `label` flag. By default, |
|
| 979 |
-docker tries to load a configuration file from `/etc/docker/daemon.json` |
|
| 980 |
-on Linux and `%programdata%\docker\config\daemon.json` on Windows. |
|
| 978 |
+of the flag name, e.g., `labels` for the `label` flag. |
|
| 981 | 979 |
|
| 982 | 980 |
The options set in the configuration file must not conflict with options set |
| 983 | 981 |
via flags. The docker daemon fails to start if an option is duplicated between |
| 984 | 982 |
the file and the flags, regardless their value. We do this to avoid |
| 985 | 983 |
silently ignore changes introduced in configuration reloads. |
| 986 | 984 |
For example, the daemon fails to start if you set daemon labels |
| 987 |
-in the configuration file and also set daemon labels via the `--label` flag. |
|
| 988 |
- |
|
| 985 |
+in the configuration file and also set daemon labels via the `--label` flag. |
|
| 989 | 986 |
Options that are not present in the file are ignored when the daemon starts. |
| 990 |
-This is a full example of the allowed configuration options in the file: |
|
| 987 |
+ |
|
| 988 |
+### Linux configuration file |
|
| 989 |
+ |
|
| 990 |
+The default location of the configuration file on Linux is |
|
| 991 |
+`/etc/docker/daemon.json`. The `--config-file` flag can be used to specify a |
|
| 992 |
+ non-default location. |
|
| 993 |
+ |
|
| 994 |
+This is a full example of the allowed configuration options on Linux: |
|
| 991 | 995 |
|
| 992 | 996 |
```json |
| 993 | 997 |
{
|
| ... | ... |
@@ -1056,6 +1060,48 @@ This is a full example of the allowed configuration options in the file: |
| 1056 | 1056 |
} |
| 1057 | 1057 |
``` |
| 1058 | 1058 |
|
| 1059 |
+### Windows configuration file |
|
| 1060 |
+ |
|
| 1061 |
+The default location of the configuration file on Windows is |
|
| 1062 |
+ `%programdata%\docker\config\daemon.json`. The `--config-file` flag can be |
|
| 1063 |
+ used to specify a non-default location. |
|
| 1064 |
+ |
|
| 1065 |
+This is a full example of the allowed configuration options on Windows: |
|
| 1066 |
+ |
|
| 1067 |
+```json |
|
| 1068 |
+{
|
|
| 1069 |
+ "authorization-plugins": [], |
|
| 1070 |
+ "dns": [], |
|
| 1071 |
+ "dns-opts": [], |
|
| 1072 |
+ "dns-search": [], |
|
| 1073 |
+ "exec-opts": [], |
|
| 1074 |
+ "storage-driver": "", |
|
| 1075 |
+ "storage-opts": [], |
|
| 1076 |
+ "labels": [], |
|
| 1077 |
+ "log-driver": "", |
|
| 1078 |
+ "mtu": 0, |
|
| 1079 |
+ "pidfile": "", |
|
| 1080 |
+ "graph": "", |
|
| 1081 |
+ "cluster-store": "", |
|
| 1082 |
+ "cluster-advertise": "", |
|
| 1083 |
+ "debug": true, |
|
| 1084 |
+ "hosts": [], |
|
| 1085 |
+ "log-level": "", |
|
| 1086 |
+ "tlsverify": true, |
|
| 1087 |
+ "tlscacert": "", |
|
| 1088 |
+ "tlscert": "", |
|
| 1089 |
+ "tlskey": "", |
|
| 1090 |
+ "group": "", |
|
| 1091 |
+ "default-ulimits": {},
|
|
| 1092 |
+ "bridge": "", |
|
| 1093 |
+ "fixed-cidr": "", |
|
| 1094 |
+ "raw-logs": false, |
|
| 1095 |
+ "registry-mirrors": [], |
|
| 1096 |
+ "insecure-registries": [], |
|
| 1097 |
+ "disable-legacy-registry": false |
|
| 1098 |
+} |
|
| 1099 |
+``` |
|
| 1100 |
+ |
|
| 1059 | 1101 |
### Configuration reloading |
| 1060 | 1102 |
|
| 1061 | 1103 |
Some options can be reconfigured when the daemon is running without requiring |