Cloud | Website | Docs | Store

Winget-Repo is a private repository for the Windows Package Manager (Winget), designed to provide software and updates within local networks without internet access. It allows centralized management, efficient installation and updating of software on multiple Windows clients.

🏆 Winget-Repo is the first private repository that supports both Winget repository types — the REST variant as well as the pre-indexed variant (similar to the official public GitHub repository).

Don't want to host it yourself? Try our Cloud Version for hassle-free deployment.

🌟 Current Features

• Easy-to-use Web Interface for managing packages and package versions 🌐
• Search, List, Show, Install and Upgrade Packages via Winget 🔍📦
• Cross-platform: The server runs on all environments that support Python 🖥️💻
• Client Overview: Track and manage your clients and control who is accessing Winget-Repo 🖥️👀
• Library for Click and Deploy Software: Simplified deployment of software with just a click 🖱️📲
• Support for Nested Installers and Package Dependencies 🛠️🔄
• Permission Management: Control access and user rights 🔐
• Terms of Service: Request the agreement of your Terms of Service 📑
• Dev-Mode: Install the Winget-Repo Dev Mode via winget configure with no problems: Setup 🪛
• Version Migration (Beta): Easily upgrade to the latest version of Winget-Repo: Documentation ⬆️🆕
• Winget-Client: Use Winget easily on your client: Github 🖥️💿
• REST-API: Rest API to Add, edit and delete Packages and Package Versions: Documentation ☁️
• Pre-Indexed Repository: Full support for the pre-indexed source type, just like the official Microsoft Community Repository Documentation 📁
• Fonts: Deploy Fonts (currently not working in the WinGet CLI when used with REST sources Issue) 📑
• Plugin Support: Extend Winget-Repo’s functionality with custom plugins Documentation 🧩

🔌 Plugins

• MCP Server: View

🚀 Upcoming Features

• Export/Import: Easily export and import your repository packages and settings 🌱
• Multilanguage: Support multiple languages 🚩
• And much more: Continuous improvements and new features on the way! ✨

🛠️ Setup Guide

Winget-Repo provides two installation methods.

⚠️ Production Note: Regardless of the installation method, it is strongly recommended to set up a reverse proxy (e.g., nginx or Apache) in front of the server for production environments. This ensures proper HTTPS termination, security, and performance.

Option A: Running with Docker 🐳

1. Pull the Image - Open your terminal and run:

   docker pull ghcr.io/dev-fynn/winget-repo:latest

2. Run the Container - Start the repository with the following command:

   docker compose up

3. Access the Interface - The server will be available locally at: https://localhost:5000

4. Settings - Enable the "Use Reverse Proxy (X-Forwarded Headers)" option in the repository settings to ensure correct IP and domain resolution. To disable TLS, add USE_SSL='False' to your .env file.

5. Restart the Server

Option B: Manual Installation 🐍

1. Download and Extract the Repository 📥
   First, download the files from the repository and extract them to any location on your system.

2. Install Python 3.10 or Higher 🐍
   Ensure that Python 3.10 or higher is installed on your machine. You can download it from the official Python website.

3. Install Packages 🔌
   Open a Command Prompt (CMD) and run the following command to install all required dependencies: pip install -r requirements.txt Make sure you installed all dependencies for pymsix correctly: Github

4. Set Up Reverse Proxy (Recommended) 🔒
   Since the connection between Winget and the repository only works over HTTPS, it is recommended to set up a reverse proxy (e.g., Apache or nginx) in front of the repository for secure communication.

   Alternative (Not Recommended) ⚠️
   If you choose not to set up a reverse proxy, you can use Flask's built-in web server with HTTPS (though this is not recommended for production). To enable HTTPS on the Flask server, modify the main.py file as follows:

   if __name__ == '__main__':
       app.run(ssl_context=(CERT_FILE, KEY_FILE))

You will also need to create your own SSL certificates using tools like OpenSSL or similar.

5. Accessing the Repository 🌐
   Once everything is set up, you should be able to access Winget-Repo under:

   https://localhost:5000

Or any port you have configured for the server.

🔗 Connecting Winget with Winget-Repo

Once the Winget-Repo server is set up and accessible, you can now connect the Winget client to the server. Follow these steps:

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:

   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_TOKEN }'}"

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

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

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!🎉

📬 Contact & Feedback

If you have any questions, suggestions, or issues, feel free to reach out via email or under the "Issues" section! Your feedback is valuable in helping us improve Winget-Repo and ensure it meets your needs. We appreciate your contributions and are here to assist with any challenges you may face!

• Mail
• Github

And if you enjoy using Winget-Repo, we'd be grateful for a star ⭐ on our repository! Thank you for your support! 🙏