Migrate to a Built-in Hub Service
Starting from YouTrack version 2024.2, we discontinued support for new installations that could be connected to an external Hub service. This option was discontinued mainly because it was no longer advantageous to use this configuration in the absence of Upsource, which reached its End of Life (EOL) in 2022.
If you're working with a YouTrack Server installation that is connected to an external Hub, you can migrate back to a Hub service that is built directly into the YouTrack installation package. This means you no longer have to manage updates, backups, security patches, and configurations for both YouTrack and an external Hub and still have access to all the functionality that is currently available in Hub.
Before you attempt to migrate your Hub service, verify that you have met the following prerequisites:
Your YouTrack installation has been upgraded to version 2024.3 or later.
Your YouTrack Server license is eligible for upgrade to version 2025.1.
Your Hub installation has been upgraded to version 2024.1 or later.
Migration to a built-in Hub service is done by creating an archive package that contains database backups from YouTrack and Hub and using this as the data source for an upgrade installation. This process consists of the following steps:
Removing unsupported services from Hub.
Creating backup copies of the databases for both Hub and YouTrack.
Merging the backups into a single archive package.
Stopping the Hub and YouTrack services.
Performing the upgrade installation.
warning
Custom JVM OptionsBefore you start, check your installation for any custom JVM options. This can include things like maximum heap size (
-Xmx
) or TLS configurations. Custom configurations will need to be removed before you start the upgrade procedure and must be reapplied.To learn how to generate a list of active JVM options, see Check JVM Options.
In your Hub installation, open the Administration menu and select Services.
Delete all the services that are not supported by the built-in Hub service. This includes:
Upsource installations that are still connected to Hub.
YouTrack installations that do not correspond with the active YouTrack Server installation that you are migrating to.
To learn how to delete a service from Hub, please refer to the Hub documentation.
Create a backup copy of your Hub database. For detailed instructions, please refer to the Hub documentation.
Create a backup copy of your YouTrack database. For detailed instructions, see Back Up the Database.
Prepare your database backup for the upgrade installation.
Extract folders and files from the YouTrack backup to a new folder in your local directory.
Extract folders and files from the Hub backup to the same folder.
Delete the conf folder and its contents.
Create an archive package from the updated folder.
Stop the Hub service. For detailed instructions, please refer to the Hub documentation.
Stop the YouTrack service. For instructions, see Stop and Restart YouTrack.
Perform an upgrade installation using a Docker image that corresponds to the version of your current YouTrack installation or later. For step-by-step instructions, see Upgrade an Existing Installation from a Database Backup using a Docker Image.
When you open the web-based Configuration Wizard, select the Upgrade path.
On the Select Upgrade Source step, select the archive package you created in step 5 of this procedure and continue with the upgrade installation.
When done, your YouTrack Server is upgraded to the target version and no longer relies on the external Hub server for authentication and user management. All the settings and features that were previously supported in your external Hub are available directly in YouTrack.
Once you have finished migrating to the built-in Hub service, take the following steps to ensure that everything is working properly.
Check the current status of the built-in Hub service by navigating to the Hub Integration page for your YouTrack Server installation. This page is accessible from the Administration > Server Settings > Global Settings page.
From this page, you can view the current status of the Hub integration and make sure everything is working as expected. If there are any problems, you can resolve them using the suggested quick-fixes.
To learn more, see Hub Integration.
If you had any custom JVM options before the migration, stop the YouTrack service and re-apply them. For detailed instructions, see Configure JVM Options.
Thanks for your feedback!