Hub 2023.2 Help

Hub for Administrators

If you are responsible for the administration of a new Hub installation, here is a list of topics that you might find helpful. These topics are listed in the order that you would normally perform the tasks that are described on each page.

If you are upgrading an existing installation to latest version, read the upgrade instructions that are relevant to your distribution type before you start.

When you're just getting started, you need to make sure that Hub is set up the way you want it and that users have the appropriate level of access to connected services. Use the topics in this list to guide yourself through this process.

Topic

Description

Installation and Upgrade

Your first step is to get your Hub installation up and running. There are separate installation instructions for each distribution package.

Secure the Connections to Your Hub Server

Hub is an application that is built to establish connections with third-party services. Whether you use built-in TLS or configure Hub to run behind a reverse proxy, secure these connections and protect your data in transit.

Connect JetBrains Teamware to Hub

Hub centralizes user authorization and access management for JetBrains team tools. When you first get started, you're likely to have user data that is stored in a database for YouTrack or TeamCity. Follow the instructions in this section to migrate your existing user data to Hub.

Backup

Verify the location, format, and interval for storing backup copies of your Hub database.

Safeguard Your Hub Installation

Hub has several features that help you keep your data safe. Follow the instructions in this guide to protect your installation from malicious users and attackers.

Protect Personal Data

Hub stores the personal data of the users who have access to the application. To address the requirements of GDPR and other regulations for data protection, you need to handle this data responsibly. Read this guide to learn about the features you can work with to secure personal data and respect the rights of your data subjects.

SMTP

To invite users to register their own accounts and send requests to restore forgotten passwords, Hub requires a connection to an email server. Read these instructions to learn how to set up a connection with an email server.

Roles

Hub provides a handful of predefined default roles for managing user permissions. Familiarize yourself with these roles and the access rights that are enabled for users when they are assigned a role in a project.

The default roles provide standard levels of access for different types of users. You can add and remove permissions for the default roles or create your own.

Groups

Check your groups and verify which roles are assigned to them. If you want to assign a specific set of permissions to a group of users, create a group and grant one or more roles that grant access to the required set of permissions. Pay attention to any group that has the auto-join option enabled. New users are added to these groups automatically and inherit the roles that are assigned to these groups.

Users

Add user accounts to the system. There are several options that you can use to create user accounts in Hub.

When you let users register their own accounts or log in with an external authentication provider, use the Auto-join Groups option to grant users a specific set of permissions automatically.

Last modified: 05 December 2023