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.
Before you begin
Section titled “Before you begin”- A Windows 10 or 11 device with winget (App Installer) installed. Run
winget --versionto check. - Administrator rights on that device.
- Any EndpointWorks plan. Free is enough.
Step 1: Sign in
Section titled “Step 1: Sign in”- Open the EndpointWorks console and go to Sign in to EndpointWorks.
- Enter your Work email and choose Sign in. If you don’t have an account, choose Create an account.
- 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.
Step 2: Add a package
Section titled “Step 2: Add a package”- Go to Packages › Discover.
- In Search community packages, search for
7-Zip. - Choose Add to catalog.
Result: the package’s versions appear in Approvals as Pending review.
Step 3: Approve a version
Section titled “Step 3: Approve a version”- Go to Approvals.
- Find 7-Zip and wait until its trust badge reads Checks passed. A new version usually takes a few minutes.
- Choose Approve.
Result: the version moves to the Approved tab. Devices can now install it.
Step 4: Create a source key
Section titled “Step 4: Create a source key”- Go to Devices & Access › Connect devices.
- Choose Create source key.
- Enter a Label, for example
Quickstart PC, and choose Create key. - Copy the winget source add command. It is shown only once.
- Choose I’ve copied it.
Step 5: Add the source on the device
Section titled “Step 5: Add the source on the device”On the Windows device, open an elevated PowerShell or Command Prompt and paste the command. It looks like this:
winget source add --name contoso --arg https://api.endpointworks.com/api/winget/t/ews_xxxxxxxx --type Microsoft.RestStep 6: Install from your source
Section titled “Step 6: Install from your source”winget install --id 7zip.7zip -s contoso --scope machineResult: winget finds the version you approved, checks the installer’s SHA-256 and installs it.
Next steps
Section titled “Next steps”- Roll the source out to more devices: Connect devices with winget.
- Decide what blocks approval: Set the security policy.
- Add your own installers: Upload a private installer.
Troubleshooting
Section titled “Troubleshooting”| 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. |