YouTrack Server 2024.3 Help

Update the URL for your Hub Server

To connect to an external Hub service, YouTrack needs to know where to look for it. The location of the external Hub service is stored in YouTrack's configuration files. To prevent accidental edits, this setting is not exposed in the administrative UI. To update this URL, you can either use the Hub migration service or update the value that is stored in a property file on the YouTrack server.

There are a few situations where you need to update the URL for an external Hub server in YouTrack.

  • The external Hub installation was reconfigured and its base URL has changed.

  • The external Hub installation was corrupted and restored to another location with a different base URL.

  • A new copy of Hub was installed in a different location, and you want YouTrack to connect to the new installation. The base URL of the new installation differs from the base URL of the old installation.

If YouTrack has stopped running and cannot start, you have to update the Hub URL manually.

Registering YouTrack as a Service in the New Hub Installation

If you're switching to a new installation, YouTrack must already be registered as a service in this Hub installation. Otherwise, YouTrack won't start. This condition is satisfied when:

  • The database for the new Hub installation was restored from a backup file that belonged to the Hub installation that was previously used by YouTrack.

  • The new Hub installation was created by migrating the previous Hub installation to the new installation.

  • The YouTrack service has been added manually to the registry for the new Hub installation. For a detailed description of this procedure, refer to the Hub documentation.

Before you attempt to update the URL for your Hub server in YouTrack, verify that YouTrack is properly registered in the new Hub installation. For more information, refer to the Hub documentation.

Updating the Hub URL Manually

If YouTrack has shut down because it can no longer connect to the Hub service, you can update the Hub URL manually. This operation is performed by applying a command to the YouTrack server.

If the certificate that secures connections to the Hub server is self-signed or not issued by a known Certificate Authority, you need to import the certificate into the internal keystore for YouTrack as well. For detailed instructions, see Update the Certificate for Your Hub Server.

To update the Hub URL manually:

  1. Open a command-line interface and enter the following command:

    docker run -it -v /path/to/conf/on/host:/opt/youtrack/conf -v ... <YT_MAGE_ID> configure --hub-url=<url-with-/hub-at-the-end>
  2. For <url-with-/hub-at-the-end>, specify the base URL for your new Hub installation and append it with /hub.

  3. Start YouTrack.

    • YouTrack connects to the Hub service using the new URL.

To update the Hub URL manually:

  1. Use one of the following methods to update the values in the bundle.properties file:

    • Open a command-line interface on the YouTrack server and enter the following command:

      <youtrack_home>/bin/youtrack.sh configure --hub-url=<url-with-/hub-at-the-end>
    • Open the <youtrack_app_data>/conf/internal/bundle.properties file and manually change the values for the following properties:

      hub-url=<url-with-/hub-at-the-end>
  2. For <url-with-/hub-at-the-end>, specify the base URL for your new Hub installation and append it with /hub.

  3. Start YouTrack.

    • YouTrack connects to the Hub service using the new URL.

Last modified: 17 June 2024