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
This reference documents all Docker Desktop settings and configuration options. Use this to understand setting behavior across different configuration methods and platforms.
10
+
This reference documents all Docker Desktop settings and configuration options. Use this to understand setting behavior across different configuration methods and platforms. It is organized to match the Docker Desktop GUI structure.
- Enterprise security recommendations where applicable
18
18
19
-
## How to use this reference
20
-
21
-
Settings are organized to match the Docker Desktop GUI structure. Configuration
22
-
methods are indicated with these labels:
23
-
24
-
- Desktop GUI: Configurable through Docker Desktop settings interface
25
-
- Admin Console: Configurable through the Docker Admin Console using Settings Management
26
-
- JSON file: Configurable through `admin-settings.json` using Settings Management
27
-
- CLI: Configurable through command-line tools
28
-
29
19
## General settings
30
20
31
21
### Start Docker Desktop when you sign in to your computer
@@ -365,20 +355,6 @@ if needed.
365
355
-**General** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
366
356
- Settings Management: `configurationFileVersion` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
367
357
368
-
### Automatically update components
369
-
370
-
| Default value | Accepted values | Format |
371
-
|---------------|-----------------|----------|
372
-
|`true`|`true`, `false`| Boolean |
373
-
374
-
-**Description:** Allow Docker Desktop to automatically update components that don't require a restart.
375
-
-**OS:** {{< badge color=blue text="All" >}}
376
-
-**Use case:** Automatically updates key Docker Desktop components such as Docker Compose, Docker Scout, the Docker CLI.
377
-
-**Configure this setting with:**
378
-
-**General settings** in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md#software-updates)
379
-
- Settings Management: `silentModulesUpdate` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
380
-
- Settings Management: **Automatically update components** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
381
-
382
358
## Resources settings
383
359
384
360
### CPU limit
@@ -484,6 +460,7 @@ edits.
484
460
-**Configure this setting with:**
485
461
-**Proxies** Resources settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
486
462
- Settings Management: `proxy` setting with `manual` and `exclude` modes in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
463
+
- Settings Management: **Proxy** section in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
487
464
488
465
> [!NOTE]
489
466
>
@@ -539,6 +516,7 @@ edits.
539
516
-**Configure this setting with:**
540
517
-**Network** Resources settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
541
518
- Settings Management: `defaultNetworkingMode` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
519
+
- Settings Management: **Default network IP mode** in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
542
520
543
521
For more information, see [Networking](/manuals/desktop/features/networking.md#networking-mode-and-dns-behaviour-for-mac-and-windows).
544
522
@@ -555,6 +533,7 @@ version 4.43 and up.
555
533
-**Configure this setting with:**
556
534
-**Network** Resources settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
557
535
- Settings Management: `dnsInhibition` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
536
+
- Settings Management: **DNS filtering behavior** in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
558
537
559
538
For more information, see [Networking](/manuals/desktop/features/networking.md#networking-mode-and-dns-behaviour-for-mac-and-windows).
560
539
@@ -786,32 +765,6 @@ method is not yet supported by Settings Management.
786
765
>
787
766
> In hardened environments, disable and lock this setting to reduce interface complexity.
788
767
789
-
### Custom Kubernetes image repository
790
-
791
-
| Default value | Accepted values | Format |
792
-
|---------------|-----------------|----------|
793
-
|`""`| Registry URL | String |
794
-
795
-
-**Description**: Registry used for Kubernetes control plane images instead of Docker Hub. This allows Docker Desktop to pull Kubernetes system
796
-
images from a private registry or mirror instead of Docker Hub. This setting
797
-
overrides the `[registry[:port]/][namespace]` portion of image names.
798
-
-**OS**: {{< badge color=blue text="All" >}}
799
-
-**Use case**: Support air-gapped environments or when Docker Hub access is restricted.
800
-
-**Configure this setting with**:
801
-
- Settings Management: `KubernetesImagesRepository` settings in the
> Images must be mirrored from Docker Hub with matching tags. Required images depend on the cluster provisioning method.
809
-
810
-
> [!IMPORTANT]
811
-
>
812
-
> When using custom image repositories with Enhanced Container Isolation, add these images to the ECI allowlist: `[imagesRepository]/desktop-cloud-provider-kind:*` and
@@ -847,6 +800,20 @@ only internally vetted versions are installed.
847
800
-**Software updates** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
848
801
- Settings Management: **Disable updates** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
849
802
803
+
### Automatically update components
804
+
805
+
| Default value | Accepted values | Format |
806
+
|---------------|-----------------|----------|
807
+
|`true`|`true`, `false`| Boolean |
808
+
809
+
-**Description:** Allow Docker Desktop to automatically update components that don't require a restart.
810
+
-**OS:** {{< badge color=blue text="All" >}}
811
+
-**Use case:** Automatically updates key Docker Desktop components such as Docker Compose, Docker Scout, the Docker CLI.
812
+
-**Configure this setting with:**
813
+
-**General settings** in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md#software-updates)
814
+
- Settings Management: `silentModulesUpdate` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
815
+
- Settings Management: **Automatically update components** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
816
+
850
817
## Extensions settings
851
818
852
819
### Enable Docker extensions
@@ -910,6 +877,7 @@ third-party or unvetted plugins from being installed.
910
877
-**Configure this setting with:**
911
878
-**Beta** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
912
879
- Settings Management: `enableDockerAI` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
880
+
- Settings Management: **Enable Docker AI** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
913
881
914
882
### Enable Docker MCP Toolkit
915
883
@@ -924,27 +892,29 @@ third-party or unvetted plugins from being installed.
924
892
-**Beta** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
925
893
- Settings Management: `enableDockerMCPToolkit` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
926
894
927
-
### Enable Wasm
895
+
### Enable Docker Offload
928
896
929
897
| Default value | Accepted values | Format |
930
898
|---------------|-----------------|----------|
931
-
|`true`|`true`, `false`| Boolean |
899
+
|`false`|`true`, `false`| Boolean |
932
900
933
-
-**Description:** Enable [Wasm](/manuals/desktop/features/wasm.md) to run Wasm workloads.
901
+
-**Description:** Enable [Docker Offload](/offload/) in Docker Desktop.
934
902
-**OS:** {{< badge color=blue text="All" >}}
935
-
-**Use case:**Run WebAssembly applications and modules within Docker containers.
903
+
-**Use case:**Offload building and running containers to the cloud.
936
904
-**Configure this setting with:**
937
905
-**Beta** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
906
+
- Settings Management: `enableCloud` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
907
+
- Settings Management: **Enable Docker Cloud** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
-**Description:** Enable [Wasm](/manuals/desktop/features/wasm.md) to run Wasm workloads.
946
916
-**OS:** {{< badge color=blue text="All" >}}
947
-
-**Use case:**Turn on enhanced Compose features and integrations.
917
+
-**Use case:**Run WebAssembly applications and modules within Docker containers.
948
918
-**Configure this setting with:**
949
919
-**Beta** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
950
920
@@ -998,7 +968,7 @@ third-party or unvetted plugins from being installed.
998
968
-**Configure this setting with:**
999
969
-**Notifications** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
1000
970
1001
-
### Docker Scout Notification pop-ups
971
+
### Docker Scout notification pop-ups
1002
972
1003
973
| Default value | Accepted values | Format |
1004
974
|---------------|-----------------|----------|
@@ -1064,10 +1034,21 @@ you relax this in a controlled way. See ECI Configuration for more info.
1064
1034
-**Configure this setting with:**
1065
1035
-**Advanced** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
1066
1036
1067
-
## Settings not available in Docker Desktop
1037
+
## Settings only available with Settings Management
1068
1038
1069
1039
The following settings aren’t shown in the Docker Desktop GUI. You can only configure them using Settings Management with the Admin Console or the `admin-settings.json` file.
1070
1040
1041
+
### Enable Docker Cloud GPU Support
1042
+
1043
+
| Default value | Accepted values | Format |
1044
+
|---------------|-----------------|----------|
1045
+
|`true`|`true`, `false`| Boolean |
1046
+
1047
+
-**Description:** Enable GPU support for Docker Cloud features.
1048
+
-**OS:** {{< badge color=blue text="All" >}}
1049
+
-**Configure this setting with:**
1050
+
- Settings Management: **Enable Docker Cloud GPU Support** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md
1051
+
1071
1052
### Block `docker load`
1072
1053
1073
1054
| Default value | Accepted values | Format |
@@ -1079,12 +1060,25 @@ The following settings aren’t shown in the Docker Desktop GUI. You can only co
1079
1060
-**Use case:** Enforce image provenance by requiring all images to come from registries.
1080
1061
-**Configure this setting with:**
1081
1062
- Settings Management: `blockDockerLoad` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
1063
+
- Settings Management: **Block Docker Load** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md
1082
1064
1083
1065
> [!NOTE]
1084
1066
>
1085
1067
> In hardened environments, enable and lock this setting. This forces all images
1086
1068
to come from your secure, scanned registry.
1087
1069
1070
+
### Hide onboarding survey
1071
+
1072
+
| Default value | Accepted values | Format |
1073
+
|---------------|-----------------|--------|
1074
+
|`false`|`true`, `false`| Boolean |
1075
+
1076
+
-**Description:** Prevent the onboarding survey from being shown to new users.
1077
+
-**OS:** {{< badge color=blue text="All" >}}
1078
+
-**Configure this setting with:**
1079
+
- Settings Management: `displayedOnboarding` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
1080
+
- Settings Management: **Block Docker Load** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md
1081
+
1088
1082
### Expose Docker API on TCP 2375
1089
1083
1090
1084
| Default value | Accepted values | Format |
@@ -1096,6 +1090,7 @@ to come from your secure, scanned registry.
1096
1090
-**Use case:** Support legacy integrations that require TCP API access.
1097
1091
-**Configure this setting with:**
1098
1092
- Settings Management: `exposeDockerAPIOnTCP2375` in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
1093
+
- Settings Management: **Expose Docker API** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md
1099
1094
1100
1095
> [!NOTE]
1101
1096
>
@@ -1113,6 +1108,7 @@ Docker API is only reachable via the secure internal socket.
1113
1108
-**Use case:** Provide controlled network access for containers in offline or restricted network environments.
1114
1109
-**Configure this setting with:**
1115
1110
- Settings Management: `containersProxy` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
1111
+
- Settings Management: **Containers proxy** section in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md
1116
1112
1117
1113
#### Example
1118
1114
@@ -1172,6 +1168,7 @@ Docker API is only reachable via the secure internal socket.
1172
1168
-**Use case:** Provide early access to features in development for testing and feedback.
1173
1169
-**Configure this setting with:**
1174
1170
- Settings Management: `allowBetaFeatures` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
1171
+
- Settings Management: **Access beta features**
1175
1172
1176
1173
> [!NOTE]
1177
1174
>
@@ -1222,3 +1219,55 @@ overrides are possible.
1222
1219
-**Use case:** Support enterprise proxy servers that require Kerberos or NTLM authentication.
1223
1220
-**Configure this setting with:**
1224
1221
- Settings Management: `proxy.enableKerberosNtlm` in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
1222
+
- Settings Management: **Kerberos NTLM** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
1223
+
1224
+
### PAC file URL
1225
+
1226
+
| Default value | Accepted values | Format |
1227
+
|---------------|-----------------|----------|
1228
+
|`""`| PAC file URL | String |
1229
+
1230
+
-**Description:** Specifies a PAC file URL. For example, `"pac": "http://proxy/proxy.pac"`.
1231
+
-**OS:** {{< badge color=blue text="All" >}}
1232
+
-**Configure this setting with:**
1233
+
- Settings Management: `pac` in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
1234
+
- Settings Management: **PAC file** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
1235
+
1236
+
### Embedded PAC script
1237
+
1238
+
| Default value | Accepted values | Format |
1239
+
|---------------|-----------------|----------|
1240
+
|`""`| Embedded PAC script | String |
1241
+
1242
+
-**Description:** Specifies an embedded PAC (Proxy Auto-Config) script. For example, `"embeddedPac": "function FindProxyForURL(url, host) { return \"DIRECT\"; }"`.
1243
+
-**OS:** {{< badge color=blue text="All" >}}
1244
+
-**Configure this setting with:**
1245
+
- Settings Management: `embeddedPac` in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
1246
+
- Settings Management: **Embedded PAC script** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
1247
+
1248
+
1249
+
### Custom Kubernetes image repository
1250
+
1251
+
| Default value | Accepted values | Format |
1252
+
|---------------|-----------------|----------|
1253
+
|`""`| Registry URL | String |
1254
+
1255
+
-**Description**: Registry used for Kubernetes control plane images instead of Docker Hub. This allows Docker Desktop to pull Kubernetes system
1256
+
images from a private registry or mirror instead of Docker Hub. This setting
1257
+
overrides the `[registry[:port]/][namespace]` portion of image names.
1258
+
-**OS**: {{< badge color=blue text="All" >}}
1259
+
-**Use case**: Support air-gapped environments or when Docker Hub access is restricted.
1260
+
-**Configure this setting with**:
1261
+
- Settings Management: `KubernetesImagesRepository` settings in the
> Images must be mirrored from Docker Hub with matching tags. Required images depend on the cluster provisioning method.
1269
+
1270
+
> [!IMPORTANT]
1271
+
>
1272
+
> When using custom image repositories with Enhanced Container Isolation, add these images to the ECI allowlist: `[imagesRepository]/desktop-cloud-provider-kind:*` and
0 commit comments