Skip to content

desktop: ms store deploy #22745

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 6, 2025
Merged

desktop: ms store deploy #22745

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f44ef4b
desktop: ms store deploy
aevesdocker Jun 2, 2025
82195fb
desktop: ms store deploy
aevesdocker Jun 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
---
title: Install Docker Desktop from the Microsoft Store on Windows
linkTitle: MS Store

Check warning on line 3 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'MS' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'MS' has no definition.", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 3, "column": 12}}}, "severity": "WARNING"}
description: Install Docker Desktop for Windows through the Microsoft Store. Understand its update behavior and limitations.
keywords: microsoft store, windows, docker desktop, install, deploy, configure, admin, mdm, intune, winget

Check failure on line 5 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'winget'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'winget'?", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 5, "column": 101}}}, "severity": "ERROR"}

Check failure on line 5 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'Intune' instead of 'intune'.

Raw Output:
{"message": "[Vale.Terms] Use 'Intune' instead of 'intune'.", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 5, "column": 93}}}, "severity": "ERROR"}

Check failure on line 5 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'mdm'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'mdm'?", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 5, "column": 88}}}, "severity": "ERROR"}

Check warning on line 5 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.RecommendedWords] Consider using 'administrator' instead of 'admin'

Raw Output:
{"message": "[Docker.RecommendedWords] Consider using 'administrator' instead of 'admin'", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 5, "column": 81}}}, "severity": "INFO"}

Check failure on line 5 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'Docker Desktop' instead of 'docker desktop'.

Raw Output:
{"message": "[Vale.Terms] Use 'Docker Desktop' instead of 'docker desktop'.", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 5, "column": 37}}}, "severity": "ERROR"}

Check failure on line 5 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'Microsoft' instead of 'microsoft'.

Raw Output:
{"message": "[Vale.Terms] Use 'Microsoft' instead of 'microsoft'.", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 5, "column": 11}}}, "severity": "ERROR"}
tags: [admin]
weight: 30
---

You can deploy Docker Desktop for Windows through the [Microsoft app store](https://apps.microsoft.com/detail/xp8cbj40xlbwkx?hl=en-GB&gl=GB).

The Microsoft Store version of Docker Desktop provides the same functionality as the standard installer but has a different update behavior depending on whether your developers install it themselves or if installation is handled by an MDM tool such as Intune. This is described in the following section.

Check warning on line 12 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.SentenceLength] Write short, concise sentences. (<=40 words)

Raw Output:
{"message": "[Docker.SentenceLength] Write short, concise sentences. (\u003c=40 words)", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 12, "column": 1}}}, "severity": "WARNING"}

Choose the installation method that best aligns with your environment's requirements and management practices.

## Update behavior

### Developer-managed installations

For developers who install Docker Desktop directly:

- The Microsoft Store does not automatically update Win32 apps like Docker Desktop for most users.
- Only a subset of users (approximately 20%) may receive update notifications on the Microsoft Store page.
- Most users must manually check for and apply updates within the Store.

### Intune-managed installations

In environments managed with Intune:
- Intune checks for updates approximately every 8 hours.
- When a new version is detected, Intune triggers a `winget` upgrade.
- If appropriate policies are configured, updates can occur automatically without user intervention.
- Updates are handled by Intune's management infrastructure rather than the Microsoft Store itself.

## WSL considerations

Check warning on line 34 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.HeadingSentenceCase] Use sentence case for headings: 'WSL considerations'.

Raw Output:
{"message": "[Docker.HeadingSentenceCase] Use sentence case for headings: 'WSL considerations'.", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 34, "column": 4}}}, "severity": "WARNING"}

Docker Desktop for Windows integrates closely with WSL. When updating Docker Desktop installed from the Microsoft Store:
- Make sure you have quit Docker Desktop and that it is no longer running so updates can complete successfully
- In some environments, virtual hard disk (VHDX) file locks may prevent the update from completing.

Check warning on line 38 in content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'VHDX' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'VHDX' has no definition.", "location": {"path": "content/manuals/desktop/setup/install/enterprise-deployment/ms-store.md", "range": {"start": {"line": 38, "column": 44}}}, "severity": "WARNING"}

## Recommendations for Intune management

If using Intune to manage Docker Desktop for Windows:
- Ensure your Intune policies are configured to handle application updates
- Be aware that the update process uses WinGet APIs rather than direct Store mechanisms
- Consider testing the update process in a controlled environment to verify proper functionality
2 changes: 1 addition & 1 deletion content/manuals/desktop/setup/install/enterprise-deployment/use-intune.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ 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]
weight: 30
weight: 40
aliases:
- /desktop/install/msi/use-intune/
- /desktop/setup/install/msi/use-intune/
Expand Down
2 changes: 1 addition & 1 deletion content/manuals/desktop/setup/install/enterprise-deployment/use-jamf-pro.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ 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
weight: 50
---

{{< summary-bar feature_name="Jamf Pro" >}}
Expand Down
Loading