YouTrack InCloud 2021.1 Help

Hub Integration

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.

The Hub integration is enabled by default. The Hub Integration page lets you troubleshoot and monitor the status of the integration.

Hub integration

To access this page, select Hub Integration in the Server Settings section of the Administration menu.

Deployment Mode

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:

Hub integration standalone

The following example shows a YouTrack InCloud instance that uses a built-in Hub service:

Hub integration InCloud

All YouTrack InCloud instances are deployed with the built-in Hub service. Connection to an external Hub service is not supported.

For a detailed description of each deployment mode, see Hub Deployment Options.

Health Indicators

The Hub Integration page displays a collection of health indicators that you can use to monitor the performance of your Hub integration. Abnormal conditions are described in red text. If any of these indicators display a status that is abnormal, contact support.

The following health indicators are displayed on this page:

Health IndicatorDescription
Connection to HubThis indicates whether YouTrack has an active connection to the Hub service. Under normal conditions, the connection status is Active and working
Hub event syncThis indicator displays the current status of the Hub event sync routine. Under normal conditions, the status is Active, syncing everything.
Permission managementHere you see the current source that is used for access authorization. Under normal conditions, the source is Hub permission management.
Hub URLThis is the URL of your Hub service.
YouTrack Service IDHere 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.


The Hub Integration page includes a set of tools that you can use to identify and fix problems with the Hub integration. The following operations are available:

SyncFor improved performance, there are a number of objects that are stored in both the Hub and YouTrack databases. This includes users and their related records for group membership, licenses, notification settings, and so on. These duplicated data structures are mapped using universally unique identifiers (UUIDs).

A background routine regularly checks both sides of the mapping, eliminating possible data discrepancies. If you experience problems with the connection between YouTrack and Hub, the two databases can be out of sync.

This operation synchronizes records for users and groups, using Hub as the data source.

ExportAn export routine regularly locates records that only exist in YouTrack and exports them to the Hub database.

This operation locates orphan entities that have not been exported, assigns them UUIDs, and exports them to Hub.

Run diagnosticsThis operation conducts a range of self-checks that locate broken mappings, identify suspicious data patterns, and diagnose other problems with the Hub integration. If a problem is located, the diagnostics routine offers a quickfix action, when available. Quickfix actions are found in the Integration Log at the bottom of the page.

There is also a routine diagnostics check that runs in the background. If the background routine detects a problem, you will also see suggestions for available quickfixes in the integration log.

Invalidate cachesHub provides YouTrack with a remote permissions cache. This cache is used to check user permissions in memory without making network calls to Hub.

During Hub outages or similar events, the permissions cache may become corrupted. This operation flushes the local permission cache and reloads fresh data from Hub. If you experience unusual behavior related to access permissions in YouTrack, run this operation.


Integration Log

At the bottom of the Hub Integration page, you find a list of recent events that have been written to the integration log.

Hub integration log

Check this section of the page for quickfixes. Use quickfixes to resolve problems that are detected by the diagnostics routine.

Last modified: 08 March 2021