From 074c07b4e9b2074e646f29412b8882f41b1bc400 Mon Sep 17 00:00:00 2001 From: Claude Docs Agent Date: Mon, 23 Mar 2026 17:59:20 +0100 Subject: [PATCH] Remove version-relative language from MSI installer note Remove the "Starting with Docker Desktop version 4.60 and later," prefix from the in-app updates note, which violates the style guide prohibition on temporal and version-relative framing. Fixes #24470 Co-Authored-By: Claude Sonnet 4.6 --- .../msi-install-and-configure.md | 62 +++++++++---------- 1 file changed, 31 insertions(+), 31 deletions(-) diff --git a/content/manuals/enterprise/enterprise-deployment/msi-install-and-configure.md b/content/manuals/enterprise/enterprise-deployment/msi-install-and-configure.md index 4221314286..d0a5490622 100644 --- a/content/manuals/enterprise/enterprise-deployment/msi-install-and-configure.md +++ b/content/manuals/enterprise/enterprise-deployment/msi-install-and-configure.md @@ -5,11 +5,11 @@ keywords: msi, windows, docker desktop, install, deploy, configure, admin, mdm tags: [admin] weight: 10 aliases: - - /desktop/install/msi/install-and-configure/ - - /desktop/setup/install/msi/install-and-configure/ - - /desktop/install/msi/ - - /desktop/setup/install/msi/ - - /desktop/setup/install/enterprise-deployment/msi-install-and-configure/ + - /desktop/install/msi/install-and-configure/ + - /desktop/setup/install/msi/install-and-configure/ + - /desktop/install/msi/ + - /desktop/setup/install/msi/ + - /desktop/setup/install/enterprise-deployment/msi-install-and-configure/ --- {{< summary-bar feature_name="MSI installer" >}} @@ -24,14 +24,14 @@ The MSI package supports various MDM (Mobile Device Management) solutions, makin 4. Once downloaded, double-click `Docker Desktop Installer.msi` to run the installer. 5. After accepting the license agreement, choose the install location. By default, Docker Desktop is installed at `C:\Program Files\Docker\Docker`. 6. Configure the Docker Desktop installation. You can: + - Create a desktop shortcut - - Create a desktop shortcut + - Set the Docker Desktop service startup type to automatic - - Set the Docker Desktop service startup type to automatic + - Disable Windows Container usage - - Disable Windows Container usage + - Select the Docker Desktop backend: WSL or Hyper-V. If only one is supported by your system, you won't be able to choose. - - Select the Docker Desktop backend: WSL or Hyper-V. If only one is supported by your system, you won't be able to choose. 7. Follow the instructions on the installation wizard to authorize the installer and proceed with the install. 8. When the installation is successful, select **Finish** to complete the installation process. @@ -45,7 +45,7 @@ If your administrator account is different from your user account, you must add > [!NOTE] > > When installing Docker Desktop with the MSI, in-app updates are automatically disabled by default. This ensures organizations can maintain version consistency and prevent unapproved updates. -> Starting with Docker Desktop version 4.60 and later, in-app updates from an MSI installation can be enabled by changing the `disableUpdate` setting to `false` through [Settings Management](../security/hardened-desktop/settings-management/). +> In-app updates from an MSI installation can be enabled by changing the `disableUpdate` setting to `false` through [Settings Management](../security/hardened-desktop/settings-management/). > > Docker Desktop notifies you when an update is available. To update Docker Desktop, download the latest installer from the Docker Admin Console. Navigate to the **Enterprise deployment** page. > @@ -161,6 +161,7 @@ IdentifyingNumber Name ----------------- ---- {10FC87E2-9145-4D7D-B493-2E99E8D8E103} Docker Desktop ``` + > [!NOTE] > > This command may take some time, depending on the number of installed applications. @@ -199,27 +200,26 @@ msiexec /x "DockerDesktop.msi" /quiet In addition to the following custom properties, the Docker Desktop MSI installer also supports the standard [Windows Installer command line options](https://learn.microsoft.com/en-us/windows/win32/msi/standard-installer-command-line-options). -| Property | Description | Default | -| :--- | :--- | :--- | -| `ENABLEDESKTOPSHORTCUT` | Creates a desktop shortcut. | 1 | -| `INSTALLFOLDER` | Specifies a custom location where Docker Desktop will be installed. | C:\Program Files\Docker | -| `ADMINSETTINGS` | Automatically creates an `admin-settings.json` file which is used to [control certain Docker Desktop settings](/manuals/enterprise/security/hardened-desktop/settings-management/_index.md) on client machines within organizations. It must be used together with the `ALLOWEDORG` property. | None | -| `ALLOWEDORG` | Requires the user to sign in and be part of the specified Docker Hub organization when running the application. This creates a registry key called `allowedOrgs` in `HKLM\Software\Policies\Docker\Docker Desktop`. | None | -| `ALWAYSRUNSERVICE` | Lets users switch to Windows containers without needing admin rights | 0 | -| `DISABLEWINDOWSCONTAINERS` | Disables the Windows containers integration | 0 | -| `ENGINE` | Sets the Docker Engine that's used to run containers. This can be either `wsl` , `hyperv`, or `windows` | `wsl` | -| `PROXYENABLEKERBEROSNTLM` | When set to 1, enables support for Kerberos and NTLM proxy authentication. Available with Docker Desktop 4.33 and later| 0 | -| `PROXYHTTPMODE` | Sets the HTTP Proxy mode. This can be either `system` or `manual` | `system` | -| `OVERRIDEPROXYHTTP` | Sets the URL of the HTTP proxy that must be used for outgoing HTTP requests. | None | -| `OVERRIDEPROXYHTTPS` | Sets the URL of the HTTP proxy that must be used for outgoing HTTPS requests. | None | -| `OVERRIDEPROXYEXCLUDE` | Bypasses proxy settings for the hosts and domains. Uses a comma-separated list. | None | -| `OVERRIDEPROXYPAC` | Sets the PAC file URL. This setting takes effect only when using `manual` proxy mode. | None | -| `OVERRIDEPROXYEMBEDDEDPAC` | Specifies an embedded PAC (Proxy Auto-Config) script. This setting takes effect only when using `manual` proxy mode and has precedence over the `OVERRIDEPROXYPAC` flag.| None | -| `HYPERVDEFAULTDATAROOT` | Specifies the default location for the Hyper-V VM disk. | None | -| `WINDOWSCONTAINERSDEFAULTDATAROOT` | Specifies the default location for Windows containers. | None | -| `WSLDEFAULTDATAROOT` | Specifies the default location for the WSL distribution disk. | None | -| `DISABLEANALYTICS` | When set to 1, analytics collection will be disabled for the MSI. For more information, see [Analytics](#analytics). | 0 | - +| Property | Description | Default | +| :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------- | +| `ENABLEDESKTOPSHORTCUT` | Creates a desktop shortcut. | 1 | +| `INSTALLFOLDER` | Specifies a custom location where Docker Desktop will be installed. | C:\Program Files\Docker | +| `ADMINSETTINGS` | Automatically creates an `admin-settings.json` file which is used to [control certain Docker Desktop settings](/manuals/enterprise/security/hardened-desktop/settings-management/_index.md) on client machines within organizations. It must be used together with the `ALLOWEDORG` property. | None | +| `ALLOWEDORG` | Requires the user to sign in and be part of the specified Docker Hub organization when running the application. This creates a registry key called `allowedOrgs` in `HKLM\Software\Policies\Docker\Docker Desktop`. | None | +| `ALWAYSRUNSERVICE` | Lets users switch to Windows containers without needing admin rights | 0 | +| `DISABLEWINDOWSCONTAINERS` | Disables the Windows containers integration | 0 | +| `ENGINE` | Sets the Docker Engine that's used to run containers. This can be either `wsl` , `hyperv`, or `windows` | `wsl` | +| `PROXYENABLEKERBEROSNTLM` | When set to 1, enables support for Kerberos and NTLM proxy authentication. Available with Docker Desktop 4.33 and later | 0 | +| `PROXYHTTPMODE` | Sets the HTTP Proxy mode. This can be either `system` or `manual` | `system` | +| `OVERRIDEPROXYHTTP` | Sets the URL of the HTTP proxy that must be used for outgoing HTTP requests. | None | +| `OVERRIDEPROXYHTTPS` | Sets the URL of the HTTP proxy that must be used for outgoing HTTPS requests. | None | +| `OVERRIDEPROXYEXCLUDE` | Bypasses proxy settings for the hosts and domains. Uses a comma-separated list. | None | +| `OVERRIDEPROXYPAC` | Sets the PAC file URL. This setting takes effect only when using `manual` proxy mode. | None | +| `OVERRIDEPROXYEMBEDDEDPAC` | Specifies an embedded PAC (Proxy Auto-Config) script. This setting takes effect only when using `manual` proxy mode and has precedence over the `OVERRIDEPROXYPAC` flag. | None | +| `HYPERVDEFAULTDATAROOT` | Specifies the default location for the Hyper-V VM disk. | None | +| `WINDOWSCONTAINERSDEFAULTDATAROOT` | Specifies the default location for Windows containers. | None | +| `WSLDEFAULTDATAROOT` | Specifies the default location for the WSL distribution disk. | None | +| `DISABLEANALYTICS` | When set to 1, analytics collection will be disabled for the MSI. For more information, see [Analytics](#analytics). | 0 | Additionally, you can also use `/norestart` or `/forcerestart` to control reboot behaviour.