📖 Winget-Repo Upgrade Guide (BETA)

Follow these steps to upgrade your Winget-Repo database and server files safely.

🐳 Docker (recommended)

1. Stop the container

docker compose down

2. Backup your old Database

Backup your existing Database.db from /Config/Database.

3. Pull the latest image

docker compose pull

4. Start the container

docker compose up -d

The startup script will automatically: - Detect Database.db in the /Config/Database folder - Renames the old database to old_database.db - Create a fresh Database.db with the new schema - Migrate all data from old_database.db into Database.db - Rename old_database.db to old_database_migrated.db so the migration does not run again on the next start

5. Verify the migration

docker logs winget-repo

You should see:

[STARTUP] old_database.db found – running migration...
[STARTUP] Migration complete.
[STARTUP] old_database.db renamed to old_database_migrated.db...

✅ Done! The server is now running with the migrated database.

🖥️ Manual

1. Stop the Winget-Repo server

Before performing any changes, make sure the running server process is stopped. If the server is running as a service or in a console, shut it down gracefully.

2. Backup the old database

Navigate to the folder where your current database is located and safe it.

3. Replace the old server files

Download the latest Winget-Repo server files and replace the old ones.

⚠️ Important: Do not overwrite your settings.py and .env file unless you intentionally want to reset your configuration. If you made custom changes (database paths, API keys, ports, etc.), make sure to copy those settings over to the new version.

4. Restart the Winget-Repo server

The server startup check reads data from Database.db, renames it to old_database.db and writes it into the new Database.db with the updated schema.

✅ Done! Your Winget-Repo server is now upgraded with the migrated database.