Logo
Winget-Repo Documentation

🔗 Connect to Your Winget Repository via REST

Follow these steps to connect any Windows Client to your local Winget-Repo instance via REST. The pre-indexed source should be deactivated in the settings to function.

  1. Open Command Prompt as Administrator 🖥️
    On the client that needs to connect to the Winget-Repo server, open a Command Prompt (CMD) with administrator rights.

  2. Add the Winget-Repo Source
    In the Command Prompt, execute the following command: bash winget source add -n Winget-Repo -t "Microsoft.Rest" -a https://{URL of the server}/api/ Replace {URL of the server} with the actual URL of your Winget-Repo server.

  3. Client authentication 🔒
    If client authentication is enabled on the server, include the following parameter: --header "{'Token': '{ CLIENT_AUTH_TOKEN }'}"

Replace {CLIENT_AUTH_TOKEN} with the client token obtained from Client Management on the server.

Note: The token must be included in every client request.

  1. Confirmation
    If the setup is successful, you should see the following message: Source is being added: Winget-Repo -> https://{URL of the server}/api/ Done

🔗 Connect to Your Winget Repository via the pre-indexed Source

Follow these steps to connect any Windows Client to your local Winget-Repo instance via the pre-indexed source. The pre-indexed source should be activated in the settings to function.

  1. Open Command Prompt as Administrator 🖥️
    On the client that needs to connect to the Winget-Repo server, open a Command Prompt (CMD) with administrator rights.

  2. Add the Winget-Repo Source
    In the Command Prompt, execute the following command: bash winget source add Winget-Repo_Indexed --arg https://{URL of the server}/api/indexed Replace {URL of the server} with the actual URL of your Winget-Repo server.

  3. Client authentication 🔒
    Client authentication is not available for the pre-indexed source. Make sure you limit the access via the IP-Restriction setting.

  4. Confirmation
    If the setup is successful, you should see the following message: Source is being added: Winget-Repo -> https://{URL of the server}/api/ Done

After completing these steps, your Winget-Repo should be ready to serve software and updates to clients within your local network!🎉