Migrations
5.0.0¶
5.0.0 is a major upgrade including breaking changes.
There should be no reason why this upgrade would fail, but here is a list of what to check and do before and after upgrading.
What to check/do before upgrading¶
Step 1: Make sure to be on the latest 4.24.1 version before upgrading to 5.0.0
Step 2: Make sure to back up your Repomanager data before upgrading. This includes volumes repomanager-data and repomanager-repo. See Backup and restore.
Step 3: If possible, test the upgrade on a staging environment before doing it on production.
What to check/do after upgrading¶
Once upgraded, check the Docker container output with:
Check for the yellow xxx migration started messages and wait until 5.0.0 migration completed. Please check that everything is fine with your repositories. is displayed. Make sure there are no red error messages in between.
______ ____ ______ ____ _____ _____ ____ _____ ____ ___________
\_ _ \/ __ \\____ \ / _ \ / \\__ \ / \\__ \ / ___\_/ __ \_ __ \
| | \| ___/| |_> ) (_) ) Y Y \/ __ \| | \/ __ \/ /_/ > ___/| | \/
|__| \___ > __/ \____/|__|_| (____ /___| (____ |___ / \___ >__|
\/|__| \/ \/ \/ \/_____/ \/
[Tue Sep 02 08:58:15] Setting permissions...
.
[Tue Sep 2 08:59:38] Databases check and initialization successful
[Tue Sep 2 08:59:38] Enabling maintenance page
[Tue Sep 2 08:59:38] Updating database
[Tue Sep 2 08:59:38] 5.0.0 stats database migration started
[Tue Sep 2 08:59:38] 5.0.0 stats database migration completed.
[Tue Sep 2 08:59:38] 5.0.0 repositories migration started
[Tue Sep 2 08:59:39]
[Tue Sep 2 08:59:39] Migrating DEB repository: debian > bookworm > contrib
[Tue Sep 2 08:59:39] - Snapshot: 31-08-2025
[Tue Sep 2 08:59:39] - Environment: preprod
[Tue Sep 2 08:59:39] -> Moving snapshot to /home/repo/deb/debian/bookworm/contrib/2025-08-31
[Tue Sep 2 08:59:39] -> Recreating environment symlink: preprod
[Tue Sep 2 08:59:39] -> Removing old environment symlink: /home/repo/debian/bookworm/contrib_preprod
[Tue Sep 2 08:59:39]
[Tue Sep 2 08:59:39] Migrating DEB repository: debian > bookworm > main
[Tue Sep 2 08:59:39] - Snapshot: 29-08-2025
[Tue Sep 2 08:59:39] - Environment: preprod
[Tue Sep 2 08:59:39] -> Moving snapshot to /home/repo/deb/debian/bookworm/main/2025-08-29
[Tue Sep 2 08:59:39] -> Recreating environment symlink: preprod
[Tue Sep 2 08:59:39] -> Removing old environment symlink: /home/repo/debian/bookworm/main_preprod
[Tue Sep 2 08:59:39]
[Tue Sep 2 08:59:39] Migrating DEB repository: debian > bookworm > non-free
[Tue Sep 2 08:59:39] - Snapshot: 29-08-2025
[Tue Sep 2 08:59:39] - Environment: preprod
[Tue Sep 2 08:59:39] -> Moving snapshot to /home/repo/deb/debian/bookworm/non-free/2025-08-29
[Tue Sep 2 08:59:39] -> Recreating environment symlink: preprod
[Tue Sep 2 08:59:39] -> Removing old environment symlink: /home/repo/debian/bookworm/non-free_preprod
[...]
[Tue Sep 2 08:59:39] 5.0.0 migration completed. Please check that everything is fine with your repositories.
[Tue Sep 2 08:59:39] Disabling maintenance page
If an error occurs during the migration process, please open a GitHub issue and provide the logs or contact support via Discord. Then restore a backup if needed, see Restoring from backup.
Log in to the Repomanager web interface and check that everything is working correctly with your repositories.
If possible, try to perform some snapshot updates and make sure everything is working correctly.
Your repository URLs have changed. You need to update the repository URLs on all your clients (select snapshots > Install). See Install a repository on a client.