Skip to content

Quickstart

This guide takes you from a new account to the first winget install from your own source. It takes about 15 minutes. You need no agent.

  • A Windows 10 or 11 device with winget (App Installer) installed. Run winget --version to check.
  • Administrator rights on that device.
  • Any EndpointWorks plan. Free is enough.
  1. Open the EndpointWorks console and go to Sign in to EndpointWorks.
  2. Enter your Work email and choose Sign in. If you don’t have an account, choose Create an account.
  3. Complete sign-in. You land on Overview.

The first person to sign in from a new organization becomes its Super admin. See Sign in and create an account.

  1. Go to Packages › Discover.
  2. In Search community packages, search for 7-Zip.
  3. Choose Add to catalog.

Result: the package’s versions appear in Approvals as Pending review.

  1. Go to Approvals.
  2. Find 7-Zip and wait until its trust badge reads Checks passed. A new version usually takes a few minutes.
  3. Choose Approve.

Result: the version moves to the Approved tab. Devices can now install it.

  1. Go to Devices & Access › Connect devices.
  2. Choose Create source key.
  3. Enter a Label, for example Quickstart PC, and choose Create key.
  4. Copy the winget source add command. It is shown only once.
  5. Choose I’ve copied it.

On the Windows device, open an elevated PowerShell or Command Prompt and paste the command. It looks like this:

Terminal window
winget source add --name contoso --arg https://api.endpointworks.com/api/winget/t/ews_xxxxxxxx --type Microsoft.Rest
Terminal window
winget install --id 7zip.7zip -s contoso --scope machine

Result: winget finds the version you approved, checks the installer’s SHA-256 and installs it.

Problem Fix
Approve is disabled The reason is shown next to the button. Usually the checks have not finished, or a finding blocks approval. See Review and approve a version.
winget source add fails Run it as administrator, and check that the device reaches the API host over HTTPS. See winget errors.
No package found matching input criteria The version is not approved yet, or you used another source name. Run winget search 7zip -s contoso.
You lost the command Create a new key. Keys can’t be shown again.