Skip to main content

device windows deploy

Overview​

Installs applications on a Windows machine using winget, driven by a JSON manifest. Supports device-specific overrides, category filtering, and required-only installs. Skips packages that are already installed.

Usage​

device windows deploy [OPTIONS]

Options​

OptionDescriptionDefault
-m, --manifest PATHManifest file pathwindows/apps/manifest.json
-d, --device DEVICEDevice ID for override (auto = hostname detection)--
--required-onlyOnly install required packagesfalse
-c, --category CATEGORYOnly install packages from this categoryAll

Prerequisites​

  • Repo: device-deployments
  • Platform: Windows 10/11
  • Dependencies: winget (App Installer)
  • Manifest: windows/apps/manifest.json with package definitions

Examples​

Deploy all apps from default manifest​

device windows deploy

Deploy only required packages​

device windows deploy --required-only

Deploy with device-specific overrides (auto-detect hostname)​

device windows deploy -d auto

Deploy only a specific category​

device windows deploy -c development

Output​

Deployment summary showing total, installed, skipped, and failed package counts.