Grant Katalon Licenses

In this guide, you will learn to assign Katalon Studio Enterprise (KSE) and Katalon Runtime Engine (KRE) licenses to Users in your Organization.

Grant a license

Requirements:

  • An internet connection for you and the users you will grant the license to.

  • You must be the Owner or Admin of your Organization.

  • You have already added team members to your Organization. See: TestOps User Management.

Follow these steps to grant KSE/KRE licenses:

  1. Sign in to Katalon TestOps, select your Organization, then go to Settings > License Management.

    The License Management page appears as below.

    license management page
  2. Choose between KSE (per-User) and KRE (Floating).

Notes:

See Types of Licenses to understand the KSE per-User license and the KRE floating license.

  1. In the Licensed Users section, click Assign License .

    The Assign License page appears as below.

    assign license page
  2. Enter the user's email address you want to assign the license to.

    Notes:

    You can assign the license to multiple users.

  3. Click Assign License to confirm.

You have granted the KSE/KRE licenses to your users.

Notes:

  • For KSE per-User licenses, the number of assigned users cannot exceed the license quota.

  • For KRE floating licenses, there is no limit on the number of assigned users. However, to optimize license usage and avoid session termination, the Owner and Admin must remember the following rules:

    • Each session accounts for one license.
    • The number of parallel sessions cannot exceed the license quota.
    • Users need API Keys to activate a KRE online license.

Your users can now activate their KSE and KRE licenses. You can refer them to this link for activation: Activate Katalon License.

Granting a license this way allows you to transfer a license freely among registered users of an Organization as long as the number of licensed users does not exceed the license quota.

You can remove these licenses and reattribute them any time by following this guide: Transfer a license.

If the users you wish to grant a license to are not connected to the internet, you can instead generate an offline license.

Create an offline license

An Offline License allows you to use KSE and KRE without internet. Once an offline license is generated, you cannot revoke or transfer it to a different machine.

By default, an offline license expires at the end of your subscription period. It can also be set to expire earlier by inputting a different expiry date when generating the offline license file.

When an offline license expires, you can generate a new offline license file to continue using KSE/KRE offline, or you can use an online license instead.

As a machine ID is required to create an offline license, Katalon generates a machine ID based on the hardware specifications and the user's account logging in to that machine.

For example, if User A logs in to A's account on Machine A, Katalon generates a machine ID X. If User B logs in to B's account on Machine A, Katalon generates a machine ID Y. This means that you need two offline licenses for User A and User B.

Notice:

Once converted to an offline license, a KSE/KRE license is bound to a machine until it expires. You cannot undo this action.

Requirements:

  • You can only convert an annual license into an offline license.

  • You must be the Owner or Admin of your Organization.

  • You have already received the User's machine ID. You can send this guide to your users: View Machine ID, for instructions on how to find a machine ID.

Follow these steps:

  1. Sign in to Katalon TestOps.

  2. Go to Settings > License Management.

    The License Management page appears.

  3. Choose between KSE (per-User) and KRE (Floating).

  4. Scroll down to the Offline Licenses section, then click on the Create Offline License button.

    create offline license page
  5. Enter the User's machine ID and input the expiry date, then click Create.

    create offline license page

    You can also add a note on the offline license in the Description section.

Notes:

You should double check the machine IDs to make sure you distribute offline licenses to the right users.

  1. Confirm the information in the popup window, then click Create.

    create offline license popup

    You have created an offline license.

    For KSE, the newly-created offline license file is named KSE_<machineID>.lic and added in the Offline Licenses section.

    For KRE, the newly-created offline license file is named KRE_<machineID>.lic and added in the Offline Licenses section.

  2. Download and transfer the offline license files to the User.

  3. Send your users this activation guide: Activate Katalon License.

See also:

Feedback