YouTrack Server 2022.1 Help

Migrate YouTrack Data to External Hub

YouTrack comes with a built-it Hub service. This service handles user and access management for the application.

To switch your current installation of YouTrack to use an external Hub service, you need to migrate the user, access, and project-related data to this external Hub. Starting with YouTrack 2018.2, you can connect any type of YouTrack Server distribution to an external Hub service.

For more information about connecting JetBrains team tools to Hub, refer to the Hub documentation.

To migrate data from built-in Hub to an external Hub service:

  1. Install and configure an external Hub server.

  2. In the YouTrack instance with the built-in Hub, create a backup of the database.

  3. Open and log in to the YouTrack migration service:

    • To open the migration service, open the Administration menu > Hub Integration and click the Migrate to external Hub link in the information pane on the page.

      External hub migration link
      • The log in page for the application migration service opens.

      Migration log in to console
    • Log in to the migration service.

      To log in to the migration service, you need to prove that you are a system administrator and have access to the file system of the server where the application is installed. To confirm your access rights, the migration service asks for a token that is located on the application server.

      • Click the Show token location link.

      • Open the awcToken.properties file that is stored on the server.

      • Paste the token from the file into the Token field.

      • Click the Log in button.

  4. Enter the base URL of the external Hub server.

  5. Click the Verify URL button.

  6. Click the Accept button to confirm the request access to the external Hub service.

    • The migration process starts.

  7. Review and resolve conflicts (if any were found) and confirm the migration.

    • The data from the built-in Hub is migrated to the external Hub service.

    • When finished, the application uses the external Hub service for user and access management.

    • The built-in Hub service is shut down.

Last modified: 06 July 2022