Deploy software with App Hub (Winget)
Add a Winget app to the catalogue, then install it on a target device set via Software Deployment.
Deploy software with App Hub (Winget)
App Hub is a catalogue; it does not install software by itself. To roll an app out to devices you combine two Collections features: App Hub supplies the package definition, and Software Deployment wraps that definition in a deployment job with targets, scheduling, and per-device result tracking. This guide walks through picking a Winget app into App Hub and rolling it out to a small group with the Software Deployment wizard.

Before you start
- Target devices are online and assigned a policy.
- For Winget apps, target devices are Windows and have Winget available (Windows 10 1809+ or Windows 11).
- Required permissions:
collections_enabled,collections_app_hub_enabledand one of the browser flags (collections_app_hub_browse_wingetfor Winget); pluscollections_software_deployment_enabledandcollections_software_deployment_addfor the deployment.
Steps
Add a Winget app to App Hub
- Open
Collections → App Hub(route/app_hub_manage_apps). - Either click
Refresh catalogsfirst to sync the remote catalogues, or use the Winget Catalog Browser directly. - Open the Winget Catalog Browser, search for the app you want (for example
7zip.7zip), select it, and clickAdd to Catalog. The app appears in the App Hub list with thewingetsource chip, publisher, and version.
Alternatively, click Add on App Hub to open the manual-entry dialog, pick Winget as the source, and paste the Winget Package ID and Winget Source directly.
Create a deployment
- Open
Collections → Software Deployment(route/software_deployment). - Click
New Deployment. Enter aNameand optionally a description at the top of the page; the four-step wizard is below it. - Step 1: Packages. In
Search catalog, find the app you added and pick it; it is added to the list below. ChooseInstallin itsActioncolumn. - Step 2: Targets. Pick tenants, locations, groups, or individual devices. Tick
Automatically include future group members(or the matching option for tenants and locations) if devices that join the selected scope later should be picked up automatically. - Step 3: Options. Set the start date and expiry if needed, the retry policy (
Max attempts per device,Backoff between retries (minutes)), and the force-reinstall and abort-on-first-failure options as needed. - Step 4: Review. Check the summary and click
Create Deployment. The deployment appears on the Software Deployment list.
Note: Software Deployment is not policy-driven. A deployment targets devices directly through its own wizard. The App Hub tab inside the Policy Settings editor is a separate setting; it only selects which apps appear in the tray icon.
Verify it worked
- The deployment shows on
/software_deploymentwith a progress indicator (finished devices / target devices) that ticks up as devices report results. - The deployment's detail page shows four info cards (Status, Progress, Author & Created, Scheduled / Expires) and a per-device result table.
- Clicking into a device on the detail page opens the per-attempt details: exit code, duration, stdout / stderr tails, and any error summary.
- On a successfully targeted device, the application is installed and reported under the device's inventory.
Troubleshooting
-
Some devices fail. Open the deployment detail page and review the per-device result. The stderr tail and exit code usually identify the cause (Winget source unavailable, package ID incorrect, insufficient disk space).
-
Install fails with an elevation or permissions error. An installer runs in a specific user context, and whether it needs administrative elevation is declared by the package maintainer, not by NetLock RMM. The App Hub entry carries an elevation setting (whether the installer requires elevation) that reflects what the maintainer specified.
Maintainers occasionally specify this incorrectly: an installer that needs elevation is marked as not requiring it, or the reverse. The installer then runs in the wrong context and reports
installation failed. When the exit code or stderr points to a permissions or elevation problem, edit the App Hub entry and test the opposite elevation setting before assuming the package itself is broken. -
An update in the tray icon's App Hub ends with
winget does not see this package as installed for the whole deviceorwinget does not find this package in your user profile. winget keeps packages that are installed for the whole device apart from packages installed for a single user. An app withRequires Elevationis updated by the agent as the system account, which only sees packages installed for the whole device. An app without it is updated by the tray icon in the user's session and only looks at the packages of that user. The tray icon offersUpdatefrom what the signed-in user's winget reports, so the action finds nothing when the package was installed the other way. SetRequires Elevationto match how the package is installed: off for a package installed for one user, on for a package installed for the whole device. TheLogsdialog shows the sentence in front of winget's own output (agent and tray icon 3.3.0.12 or later). An automatic update that meets this state is skipped without an error and tried again the next day. -
Non-Windows devices reported failure. Winget is Windows-only. Narrow the Target step to Windows devices, or add a Flathub app (Linux) or a script-based app for the other platforms.
-
App not listed in the wizard. Apps created through the public API with
availableForDeployment: falsedo not appear. Set the field totruethrough the API. -
Retry the failed devices. Click
Retryon the deployment detail page. Retry respectsMax attempts per deviceandBackoff between retries (minutes)and increments the per-device attempt counter.
Related
- Chapter 8.5 — App Hub — the catalogue, manual and browser-based entries, and
Refresh catalogs. - Chapter 8.8 — Software Deployment — the full deployment reference, including the detail page and ad-hoc single-device deployments.
- Deploy custom applications with scripts — package software not in Winget/Chocolatey/Flathub as a script-based App Hub app, with install and detection scripts.
- Deploy an installer file from the file server — run an uploaded MSI, EXE, MSU, PowerShell, DEB, RPM, shell or PKG file with parameters per action and a pinned SHA-512.
- Guide H.7 — Write, test, and schedule a PowerShell script — an alternative for manual install scripts.
Run only signed PowerShell scripts (AllSigned)
Enforce the AllSigned execution policy on managed Windows devices, trust the NetLock RMM signing certificate, and sign your own scripts so the agent still runs them.
Deploy custom applications with scripts
Create a script-based App Hub app — install, update, uninstall and detection scripts — and roll it out with Software Deployment.