docker · aevesdocker · Apr 3, 2025 · Apr 2, 2025 · Apr 2, 2025 · Apr 2, 2025
diff --git a/_vale/Docker/Acronyms.yml b/_vale/Docker/Acronyms.yml
@@ -50,6 +50,7 @@ exceptions:
   - GDB
   - GET
   - GHSA
+  - GNOME
   - GNU
   - GPG
   - GPL
@@ -74,10 +75,12 @@ exceptions:
   - JIT
   - JSON
   - JSX
+  - KDE
   - LESS
   - LLDB
   - LTS
   - MAC
+  - MATE
   - MCP
   - mcp
   - MDM

@@ -15,10 +15,14 @@
     [Windows](/desktop/setup/install/windows-install/), or
     [Linux](/desktop/setup/install/linux/).
   icon: download
-- title: Explore Docker Desktop
-  description: Navigate Docker Desktop and learn about its key features.
+- title: Learn about Docker Desktop
+  description: Navigate Docker Desktop.
   icon: feature_search
   link: /desktop/use-desktop/
+- title: Explore its key features
+  description: |
+    Find information about [Docker VMM](/desktop/features/vmm/), [WSL](/desktop/features/wsl/), [deploying on Kubernetes](/desktop/features/kubernetes/), and more.
+  icon: category
 - title: View the release notes
   description: Find out about new features, improvements, and bug fixes.
   icon: note_add
@@ -27,11 +31,6 @@
   description: Explore general FAQs or FAQs for specific platforms.
   icon: help
   link: /desktop/troubleshoot-and-support/faqs/general/
-- title: Find additional resources
-  description: |
-    Find information on networking features, deploying on Kubernetes, and more.
-  icon: category
-  link: /desktop/features/kubernetes/
 - title: Give feedback
   description: Provide feedback on Docker Desktop or Docker Desktop features.
   icon: sms
@@ -51,15 +50,18 @@
 
 Docker Desktop reduces the time spent on complex setups so you can focus on writing code. It takes care of port mappings, file system concerns, and other default settings, and is regularly updated with bug fixes and security updates.
 
+Docker Desktop integrates with your preferred development tools and languages, and gives you access to a vast ecosystem of trusted images and templates via Docker Hub. This empowers teams to accelerate development, automate builds, enable CI/CD workflows, and collaborate securely through shared repositories.
+
 {{< tabs >}}
 {{< tab name="What's included in Docker Desktop?" >}}
 
 - [Docker Engine](/manuals/engine/_index.md)
 - Docker CLI client
-- [Docker Scout](../scout/_index.md) (additional subscription may apply)
+- [Docker Scout](../scout/_index.md)
 - [Docker Build](/manuals/build/_index.md)
-- [Docker Extensions](../extensions/_index.md)
 - [Docker Compose](/manuals/compose/_index.md)
+- [Ask Gordon](/manuals/desktop/features/gordon/_index.md)
+- [Docker Extensions](../extensions/_index.md)
 - [Docker Content Trust](/manuals/engine/security/trust/_index.md)
 - [Kubernetes](https://github.com/kubernetes/kubernetes/)
 - [Credential Helper](https://github.com/docker/docker-credential-helpers/)
@@ -78,10 +80,4 @@
 {{< /tab >}}
 {{< /tabs >}}
 
-Docker Desktop works with your choice of development tools and languages and
-gives you access to a vast library of certified images and templates in
-[Docker Hub](https://hub.docker.com/). This allows development teams to extend
-their environment to rapidly auto-build, continuously integrate, and collaborate
-using a secure repository.
-
 {{< grid >}}
@@ -1,5 +1,6 @@
 ---
 title: Enterprise deployment FAQs
+linkTitle: FAQs
 description: Frequently asked questions for deploying Docker Desktop at scale
 keywords: msi, deploy, docker desktop, faqs, pkg, mdm, jamf, intune, windows, mac, enterprise, admin
 tags: [FAQ, admin]
@@ -10,23 +11,27 @@ aliases:
 
 ## MSI
 
+Common questions about installing Docker Desktop using the MSI installer.
+
 ### What happens to user data if they have an older Docker Desktop installation (i.e. `.exe`)?
 
-If they have an older `.exe` installation, users must [uninstall](/manuals/desktop/uninstall.md) this version before using the new MSI version. This deletes all Docker containers, images, volumes, and other Docker-related data local to the machine, and removes the files generated by the application. For older versions, users should [backup](/manuals/desktop/settings-and-maintenance/backup-and-restore.md) any containers that they want to keep.
+Users must [uninstall](/manuals/desktop/uninstall.md) older `.exe` installations before using the new MSI version. This deletes all Docker containers, images, volumes, and other Docker-related data local to the machine, and removes the files generated by Docker Desktop. 
+
+To preserve existing data before uninstalling, users should [backup](/manuals/desktop/settings-and-maintenance/backup-and-restore.md) their containers and volumes.
 
-For Docker Desktop versions 4.30 and later of the `exe` installer, a `-keep-data` flag is available. It removes Docker Desktop but keeps underlying data, such as the VMs that run containers.
+For Docker Desktop 4.30 and later, the `.exe` installer includes a `-keep-data` flag that removes Docker Desktop while preserving underlying resources such as the container VMs:
 
 ```powershell
 & 'C:\Program Files\Docker\Docker\Docker Desktop Installer.exe' uninstall -keep-data
 ```
 
 ### What happens if the user's machine has an older `.exe` installation?
 
-The new MSI installer checks if a previous version was installed and doesn't proceed with the installation. Instead, it prompts the user to uninstall their current/old version first, before retrying to install the MSI version.
+The MSI installer detects older `.exe` installations and blocks the installation until the previous version is uninstalled. It prompts the user to uninstall their current/old version first, before retrying to install the MSI version.
 
 ### My installation failed, how do I find out what happened?
 
-MSI installations can sometimes fail unexpectedly and not provide users with much information about what went wrong.
+MSI installations may fail silently, offering little diagnostic feedback.
 
 To debug a failed installation, run the install again with verbose logging enabled:
 

@@ -1,5 +1,5 @@
 ---
-title: Use the MSI installer
+title: MSI installer
 description: Understand how to use the MSI installer. Also explore additional configuration options.
 keywords: msi, windows, docker desktop, install, deploy, configure, admin, mdm
 tags: [admin]
@@ -21,7 +21,7 @@
 2. Under **Docker Desktop**, select the **Deploy** page.
 3. From the **Windows OS** tab, select the **Download MSI installer** button.
 4. Once downloaded, double-click `Docker Desktop Installer.msi` to run the installer.
-5. Once you've accepted the license agreement, you can choose the install location. By default, Docker Desktop is installed at `C:\Program Files\Docker\Docker`.
+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
@@ -30,19 +30,19 @@
 
     - Disable Windows Container usage
 
-    - Select the engine for Docker Desktop. Either WSL or Hyper-V. If your system only supports one of the two options, you won't be able to select which backend to use.
+    - 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.
 
-If your administrator account is different to your user account, you must add the user to the **docker-users** group:
+If your administrator account is different from your user account, you must add the user to the **docker-users** group:
 1. Run **Computer Management** as an **administrator**.
 2. Navigate to **Local Users and Groups** > **Groups** > **docker-users**.
 3. Right-click to add the user to the group.
 4. Sign out and sign back in for the changes to take effect.
 
 > [!NOTE]
 >
-> When installing Docker Desktop with the MSI, in-app updates are automatically disabled. This feature ensures your organization maintains the required Docker Desktop version. For Docker Desktop installed with the .exe installer, in-app updates remain supported.
+> When installing Docker Desktop with the MSI, in-app updates are automatically disabled. This ensures organizations can maintain version consistency and prevent unapproved updates. For Docker Desktop installed with the .exe installer, in-app updates remain supported.
 >
 > 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  **Deploy** page > under **Docker Desktop**.
 >
@@ -116,7 +116,7 @@
 
 > [!TIP]
 >
-> Some useful tips to remember when creating a value that expects a JSON string as it’s value:
+> When creating a value that expects a JSON string:
 >
 > - The property expects a JSON formatted string
 > - The string should be wrapped in double quotes
@@ -142,7 +142,7 @@
 ```
 > [!NOTE]
 >
-> This command can take some time to return, depending on the number of installed applications.
+> This command may take some time, depending on the number of installed applications.
 
 `IdentifyingNumber` is the applications product code and can be used to uninstall Docker Desktop. For example:
 
@@ -202,11 +202,11 @@
 
 Additionally, you can also use `/norestart` or `/forcerestart` to control reboot behaviour.
 
-By default, the installer reboots the machine after a successful installation. When ran silently, the reboot is automatic and the user is not prompted.
+By default, the installer reboots the machine after a successful installation. When run silently, the reboot is automatic and the user is not prompted.
 
 ## Analytics
 
-The MSI installer collects anonymous usage statistics relating to install only. This is to better understand user behaviour and to improve the user experience by identifying and addressing issues or optimizing popular features.
+The MSI installer collects anonymous usage statistics relating to installation only. This is to better understand user behaviour and to improve the user experience by identifying and addressing issues or optimizing popular features.
 
 ### How to opt-out
 
@@ -239,7 +239,7 @@
 SOFTWARE\Docker Inc.\Docker Desktop\DisableMsiAnalytics
 ```
 
-When analytics is disabled, this key has a value of `1`.
+When analytics is disabled, this key is set to `1`.
 
 ## Additional resources
 

@@ -1,5 +1,5 @@
 ---
-title: Use the PKG installer
+title: PKG installer
 description: Understand how to use the PKG installer. Also explore additional configuration options.
 keywords: pkg, mac, docker desktop, install, deploy, configure, admin, mdm
 tags: [admin]
@@ -16,17 +16,17 @@ The PKG package supports various MDM (Mobile Device Management) solutions, makin
 2. Under **Docker Desktop**, select the **Deploy** page.
 3. From the **macOS** tab, select the **Download PKG installer** button.
 4. Once downloaded, double-click `Docker.pkg` to run the installer.
-5. Follow the instructions on the installation wizard to authorize the installer and proceed with the install.
-   - **Introduction**: Select `Continue`.
-   - **License**: Review the license agreement and select `Agree`.
-   - **Destination Select**: This step is optional. It is recommended that you don't change the default installation destination (usually `Macintosh HD`). Select `Continue`.
-   - **Installation Type**: Select `Install`.
+5. Follow the instructions on the installation wizard to authorize the installer and proceed with the installation.
+   - **Introduction**: Select **Continue**.
+   - **License**: Review the license agreement and select **Agree**.
+   - **Destination Select**: This step is optional. It is recommended that you keep the default installation destination (usually `Macintosh HD`). Select **Continue**.
+   - **Installation Type**: Select **Install**.
    - **Installation**: Authenticate using your administrator password or Touch ID.
-   - **Summary**: After the installation completes, select `Close`.
+   - **Summary**: When the installation completes, select **Close**.
 
 > [!NOTE]
 >
-> When installing Docker Desktop with the PKG, in-app updates are automatically disabled. This feature ensures your organization maintains the required Docker Desktop version. For Docker Desktop installed with the .dmg installer, in-app updates remain supported.
+> When installing Docker Desktop with the PKG, in-app updates are automatically disabled. This ensures organizations can maintain version consistency and prevent unapproved updates. For Docker Desktop installed with the `.dmg` installer, in-app updates remain supported.
 >
 > 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  **Deploy** page > under **Docker Desktop**.
 >
@@ -45,5 +45,5 @@ The PKG package supports various MDM (Mobile Device Management) solutions, makin
 
 ## Additional resources
 
-- See how you can deploy Docker Desktop for Mac via [Intune](use-intune.md) or [Jamf Pro](use-jamf-pro.md)
+- See how you can deploy Docker Desktop for Mac using [Intune](use-intune.md) or [Jamf Pro](use-jamf-pro.md)
 - Explore how to [Enforce sign-in](/manuals/security/for-admins/enforce-sign-in/methods.md#plist-method-mac-only) for your users.
@@ -1,5 +1,5 @@
 ---
-title: Use Intune
+title: Deploy with Intune
 description: Use Intune, Microsoft's cloud-based device management tool, to deploy Docker Desktop
 keywords: microsoft, windows, docker desktop, deploy, mdm, enterprise, administrator, mac, pkg, dmg
 tags: [admin]
@@ -11,7 +11,7 @@ aliases:
 
 {{< summary-bar feature_name="Intune" >}}
 
-Learn how to deploy Docker Desktop for Windows and Mac using Intune, Microsoft's cloud-based device management tool. 
+Learn how to deploy Docker Desktop on Windows and macOS devices using Microsoft Intune. It covers app creation, installer configuration, and assignment to users or devices.
 
 {{< tabs >}}
 {{< tab name="Windows" >}}
@@ -20,7 +20,7 @@ Learn how to deploy Docker Desktop for Windows and Mac using Intune, Microsoft's
 2. Add a new app. Select **Apps**, then **Windows**, then **Add**.
 3. For the app type, select **Windows app (Win32)**
 4. Select the `intunewin` package. 
-5. Complete any relevant details such as the description, publisher, or app version and then select **Next**. 
+5. Fill in the required details, such as the description, publisher, or app version and then select **Next**. 
 6. Optional: On the **Program** tab, you can update the **Install command** field to suit your needs. The field is pre-populated with `msiexec /i "DockerDesktop.msi" /qn`. See the [Common installation scenarios](msi-install-and-configure.md) for examples on the changes you can make. 
 
    > [!TIP]
@@ -29,17 +29,17 @@ Learn how to deploy Docker Desktop for Windows and Mac using Intune, Microsoft's
    >
    > This is because the Docker Desktop installer installs Windows features depending on your engine selection and also updates the membership of the `docker-users` local group.
    >
-   > You may also want to set Intune to determine behaviour based on return codes and watch for a return code of `3010`. 
+   > You may also want to set Intune to determine behaviour based on return codes and watch for a return code of `3010`. Return code 3010 means the installation succeeded but a reboot is required.
 
-7. Complete the rest of the tabs and then review and create the app. 
+7. Complete the remaining tabs, then review and create the app. 
 
 {{< /tab >}}
 {{< tab name="Mac" >}}
 
 First, upload the package:
 
 1. Sign in to your Intune admin center.
-2. Add a new app. Select **Apps**, then **macOSs**, then **Add**.
+2. Add a new app. Select **Apps**, then **macOS**, then **Add**.
 3. Select **Line-of-business app** and then **Select**.
 4. Upload the `Docker.pkg` file and fill in the required details.
 
@@ -55,4 +55,4 @@ Next, assign the app:
 ## Additional resources
 
 - [Explore the FAQs](faq.md).
-- Learn how to [Enforce sign-in](/manuals/security/for-admins/enforce-sign-in/_index.md) for your users.
+- Learn how to [enforce sign-in](/manuals/security/for-admins/enforce-sign-in/_index.md) for your users.
@@ -1,32 +1,32 @@
 ---
-title: Use Jamf Pro
-description: Use Jamf Pro to deploy Docker Desktop
+title: Deploy with Jamf Pro
+description: Use Jamf Pro to deploy Docker Desktop for Mac
 keywords: jamf, mac, docker desktop, deploy, mdm, enterprise, administrator, pkg
 tags: [admin]
 weight: 40
 ---
 
 {{< summary-bar feature_name="Jamf Pro" >}}
 
-Learn how to deploy Docker Desktop for Mac using Jamf Pro.
+Learn how to deploy Docker Desktop for Mac using Jamf Pro, including uploading the installer and creating a deployment policy.
 
 First, upload the package:
 
-1. From the Jamf pro console, Navigate to **Computers** > **Management Settings** > **Computer Management** > **Packages**.
+1. From the Jamf Pro console, navigate to **Computers** > **Management Settings** > **Computer Management** > **Packages**.
 2. Select **New** to add a new package.
 3. Upload the `Docker.pkg` file.
 
 Next, create a policy for deployment:
 
 1. Navigate to **Computers** > **Policies**.
-2. Select **New**to create a new policy.
+2. Select **New** to create a new policy.
 3. Enter a name for the policy, for example "Deploy Docker Desktop".
 4. Under the **Packages** tab, add the Docker package you uploaded.
-5. Configure the scope to target the devices or device groups you want to install Docker on.
+5. Configure the scope to target the devices or device groups on which you want to install Docker.
 6. Save the policy and deploy.
 
 For more information, see [Jamf Pro's official documentation](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/Policies.html). 
 
 ## Additional resources
 
-- Learn how to [Enforce sign-in](/manuals/security/for-admins/enforce-sign-in/_index.md) for your users.
+- Learn how to [enforce sign-in](/manuals/security/for-admins/enforce-sign-in/_index.md) for your users.
-Original file line number
+Diff line change
@@ Expand Up / @@ -50,6 +50,7 @@ exceptions: @@
       - GDB
       - GET
       - GHSA
+      - GNOME
       - GNU
       - GPG
       - GPL
@@ Expand All / @@ -74,10 +75,12 @@ exceptions: @@
       - JIT
       - JSON
       - JSX
+      - KDE
       - LESS
       - LLDB
       - LTS
       - MAC
+      - MATE
       - MCP
       - mcp
       - MDM
@@ Expand Down @@