YouTrack comes with a built-in JetBrains Hub service. The Hub service is an integral part of YouTrack that provides authentication, authorization, and user management. The Hub service cannot be removed or disabled.
At the top of the Hub Integration page, you see a short description of the Hub service itself. You also see a description of the deployment modes that are available for the Hub integration. The description indicates which mode is currently enabled in YouTrack.
The following example shows a YouTrack Standalone installation that is connected to an external Hub service:
The following example shows a YouTrack InCloud instance that uses a built-in Hub service:
If you're wondering which mode is currently enabled in your YouTrack installation, check this section of the page. You can also use this information to verify whether your migration to an external Hub service was successful.
For a detailed description of each deployment mode, see Hub Deployment Options.
The Hub Integration page displays a collection of health indicators that you can use to monitor the status of your Hub integration. Use these indicators to diagnose problems with your Hub installation.
Connection to Hub
If your Hub service is down or unresponsive, this metric displays the condition that is the likely source of the problem. Use the following list to resolve the problem:
|These messages indicate problems with the installation that require technical support. To ask one of our engineers to repair the Hub integration, submit a support request.|
|YouTrack isn't trusted in Hub||In most cases, a user has accessed the list of services that are connected to Hub and has distrusted YouTrack. To resolve this problem, access the Services page in Hub and trust the YouTrack service.|
|Unknown host in Hub URL||The Hub domain name cannot be resolved by your DNS service. Check your network infrastructure or contact your ISP.|
|Can't connect to Hub||There is a connectivity issue. For details, see Troubleshooting the Hub Integration.|
|Connection to Hub timed out||Hub is unreachable or has performance issues. For details, see Troubleshooting the Hub Integration.|
Hub event sync
If the status reads Not started, contact support.
Here you see the current source that is used for access authorization. Under normal conditions, the source is Hub permission management. If the status reads YouTrack permission management, contact support.
This is the URL of your Hub service.
If you experience connectivity issues with an external Hub installation, open this URL on the machine that runs YouTrack to verify that the Hub service is accessible from YouTrack.
YouTrack Service ID
Here you find the ID that is assigned to YouTrack as a connected service in Hub.
When a service is connected to Hub, it is assigned a unique service ID. If you want to connect to YouTrack using the REST API, you use this service ID for access and authorization.
If you suspect that your Hub integration is not working as intended, follow the instructions for Troubleshooting the Hub Integration.
Check this section of the page for quickfixes. Use quickfixes to resolve problems that are detected by the diagnostics routine.