YouTrack Server 2022.1 Help

Update the Service Secret for YouTrack

If your YouTrack service was deleted from an external Hub installation by mistake, you may need to restore the service manually. The full set of instructions for this process is described in the Hub documentation.

To restore the service manually, you need to add a new service for YouTrack in Hub and generate a new service secret. You then need to take the ID that is assigned to the new service and the newly-generated service secret and update these values in the configuration files for YouTrack.

To update the service ID and secret for your YouTrack service:

  1. Stop the YouTrack service.

  2. Locate and open the hub.properties file.

    • For a ZIP distribution, the file is located in the <YouTrack installation directory>/conf directory.

    • For an MSI distribution the file is located in the %programdata%\\JetBrains\YouTrack\conf directory.

      You can locate the path to the conf folder in the <YouTrack installation directory>\internal\conf\installation.xml file. The path is written to the property default-appdata-root. For example:

      <default-appdata-root>C:\ProgramData\JetBrains\YouTrack</default-appdata-root>
  3. Update the values for the youtrack.service.id and youtrack.service.secret properties. For example:

    youtrack.service.id=d1199047-523c-4138-bcb0-5e9032969d95 youtrack.service.secret=gPQ9i7lbdvwExCAF0980QlzitmClE2Y6y4gZRTKjKXKkXPqdpP
  4. Restart the YouTrack service.

At this point, your YouTrack service should start successfully. To ensure that everything is working as it was prior to when the YouTrack service was deleted, continue to follow the instructions in the Hub documentation.

Last modified: 06 July 2022