Hub 2024.3 Help

Manage Service Licenses

The Licenses tab for a service provides tools that let you manage the service license.

Services license tab
  • The top of the page displays the basic license properties. This includes the number of users who can be granted the license and the period of validity.

  • For licenses that have a user limitation, you have options that let you manage which users and groups are allocated licenses to use the application.

Grant a Per-user License

For services that limit the number of users who can use the application, you can grant licenses to specific users and members of groups.

When you grant a license to a group, all of the users who are members of the group are granted a license. Users who are added to the group are automatically granted a license for the service until all of the available licenses have been allocated. If the group has the auto-join option enabled, users are automatically granted a license when they are added to Hub.

To grant a license:

  1. Click the Grant license button.

  2. In the Add users and groups input field, enter the name of a user or group. The list of users and groups is filtered to match the text in the input field.

    Grant license dialog
  3. Select a user or group from the drop-down list. For each group in the list, the number of users who are members of the group is displayed.

  4. Continue adding users and groups until you have allocated licenses to all of the users that need them. The number of available licenses is displayed above the input field.

  5. Click the Grant license button.

    • The licenses are granted to the selected users and members of the selected groups.

    • The number of licenses in the Available Licenses setting is updated.

    • If the number of available licenses is lesser than the number of selected users, the licenses are granted at random to selected users and members of the selected groups. Group members who were not granted licenses are shown under the users without license heading.

The Details sidebar displays the roles that each user is granted by project. Use this information to determine whether the user requires a license for the service.

License roles in projects

Revoke Licenses

If you have users or groups who no longer require licenses for an application, you can revoke the license from single users or entire groups.

To revoke a license from one or more users:

  1. Select one or more users from the list.

    • If the list is shown by groups, you can only select one user at a time. To select multiple users, click Users to switch the display mode.

    • Use the Search by user control to filter the list.

  2. Click the Revoke license button.

    Revoke license user
  3. Confirm the action in the Revoke license dialog.

    • The licenses are revoked from the selected users.

    • The number of licenses in the Available Licenses setting is updated.

To revoke a license from one or more groups:

  1. Select one or more groups from the list. This option is only available when the list is shown by groups.

  2. Click the Revoke license button.

    Revoke license group
  3. In the Revoke license dialog, select the option to revoke the license from the group and its members.

  4. Click the Revoke button.

    • The licenses are revoked from the selected group and its members.

    • The number of licenses in the Available Licenses setting is updated.

Remove Licenses from Groups

Assigning licenses to groups is a great way to streamline license allocation. However, if you find that you no longer want to grant licenses to new group members, or run out of licenses to allocate, you can remove the group without revoking the license from its members.

To remove a license from one or more groups:

  1. Select one or more groups from the list. This option is only available when the list is shown by groups.

  2. Click the Revoke license button.

    Remove license group
  3. In the Revoke license dialog, select the option to revoke the license from the group, but grant its members the license directly.

  4. Click the Revoke button.

    • The selected groups are removed from the list.

    • Members of the selected groups are granted the license directly.

    • The number of licenses in the Available Licenses setting is updated.

Edit a License

If you have renewed a license or have upgraded the user pack, you can update the license on this page.

To edit a license:

  1. Click the Edit license link.

    Edit license dialog
  2. In the Edit License dialog, edit the name of the license in the License name input field. For example, change the name from YouTrack to YouTrack 500-user.

  3. Paste the license key into the License key input field.

  4. Click the Save button.

    • The license is uploaded to the Hub server and applied to the service.

    • The properties of the license are updated.

Delete a License

You can also delete a license from a service. Use this feature only if you migrated a duplicate service to Hub and need to configure the licenses manually.

To delete a license:

  1. Click the Edit license link.

  2. In the Edit License dialog, click the Delete button.

  3. Confirm the action in the dialog.

    • The license is removed from the service.

    • The licenses are revoked from all users who are granted a license to use the service.

Last modified: 09 October 2024