From 57afcaa84aa782a7583cb060d5a8558ff16af1e9 Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 27 Aug 2026 09:45:48 +0000 Subject: [PATCH] docs: document machine-wide Sandboxes MSI Docker Sandboxes v0.42 adds an MSI for administrator-managed Windows installations. Document the two install scopes, silent machine installation, and the verified upgrade caveat. Co-Authored-By: Codex --- content/manuals/ai/sandboxes/install.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/content/manuals/ai/sandboxes/install.md b/content/manuals/ai/sandboxes/install.md index 01aa69e2d64..9d7b0397573 100644 --- a/content/manuals/ai/sandboxes/install.md +++ b/content/manuals/ai/sandboxes/install.md @@ -68,12 +68,35 @@ $ brew install docker/tap/sbx ## Install on Windows +### Install for the current user + Install `sbx` using Windows Package Manager: ```powershell winget install -h Docker.sbx ``` +WinGet installs the per-user `DockerSandboxes.msi` package in +`%LOCALAPPDATA%\DockerSandboxes` and adds its `bin` directory to your user +`PATH`. You can install it without administrator privileges. + +### Install for all users + +For administrator-managed deployments, download +`DockerSandboxesMachine.msi` from the +[Docker Sandboxes releases](https://github.com/docker/sbx-releases/releases). +From an elevated PowerShell prompt, install the package silently: + +```powershell +msiexec.exe /i DockerSandboxesMachine.msi /quiet +``` + +The machine-wide package installs in `%ProgramFiles%\DockerSandboxes` and adds +its `bin` directory to the system `PATH`. + +A machine-wide upgrade might require restarting Windows if an `sbx` daemon in +another user's session is using the installed files. + ## Install on Ubuntu > [!NOTE]