Install a Subscription License

To activate Ranorex Subscription License, follow the steps below. Also, find some troubleshooting tips in case any issues arise during activation.

Requirements

To successfully activate and validate a subscription license, ensure the following:

• Ability to connect via HTTPS (port 443).
• Access to https://keygen.sh/ and its subdomains for license validation. 
• If your network uses an authenticated proxy, configure the proxy settings in the Configure Ranorex License dialog.
• Installed versions:
  • To use the online subscription licensing model, ensure you use Ranorex Studio version 12.1.2 or higher. 
  • To use the self-hosted subscription licensing model, ensure you use Ranorex Studio version 12.5.0 or higher.

Warning: Subscription licenses do not require the License Manager to be installed. To avoid unexpected issues, make sure that no other license types rely on the previous License Manager software, or uninstall it completely.

1. Download and install Ranorex Studio using the following link: Ranorex Studio Downloads.
2. After installation, open Ranorex Studio. Navigate to the Help menu in the top toolbar, then select Licensing… to open the Configure Ranorex License dialog.
   
3. In the License dialog, select the Subscription option to proceed with subscription-based licensing.
   

4. Enter the License Key provided, click Validate to confirm, and continue the activation process.
   

   Hint: Need to configure a subscription license on a machine with only Ranorex Runtime installed? Click here to learn how.

If you encounter a validation error, ensure your license is still valid; otherwise, renew it. If the error message states that the maximum activations have been reached, deactivate any unused machines to free up activations.

Note (Online License Manager only): If you experience issues connecting to the NTP server (time.microsoft.com), it may be due to blocked UDP access. For more details and troubleshooting, see Error: Cannot Connect to time.windows.com. 
This does not apply to the Self-Hosted Subscription License Manager, which does not require an NTP server connection.

Install Self-Hosted Subscription License

Before configuring your Self-Hosted Subscription License in Ranorex Studio, make sure you have completed these previous steps:

• Install License Manager
• Activate Your Ranorex Self-Hosted Subscription License

Once you have completed the activation of your license in the Ranorex Subscription License Manager (self-hosted), complete these steps to let Ranorex Studio use it:

1. Open Ranorex Subscription License Manager, in the Licenses tab, and copy the License Key and upload License file (.lic)
2. Launch Ranorex Studio and, on the Welcome screen, select I have a license option.
3. In the Configure Ranorex License window, select Floating under the Subscription option.
   
4. In the Enter your subscription key field, paste the key generated by Subscription License Manager from the License Key column, not the value in the Original Key column.
   

5. Open the Advanced settings, then enter the License Manager URL.

   Note: If custom ports were configured for NGINX during the initial setup, make sure to specify that port again when installing the license. 
   For example, if you used port 1025, be sure to include it in this step as follows: https://localhost:1025

   
   When connecting from another machine, specify the IP address of the machine running Subscription License Manager.
   

   Note: You can copy this URL from the License Manager tab in Ranorex Subscription License Manager.

6. Optional: If your network uses a proxy server for license validation, click Configure Proxy. 
   

   1. In the Configure Proxy dialog, complete the required proxy settings.
      

      Field	Description
      Proxy server URL	Enter the proxy server URL required by your network.
      Type	Select the credential type used by your proxy server: Anonymous, Default, or Custom. Select Default to use your system or Windows credentials for proxy authentication
      User name	Enter the proxy user name. This field appears only when “Custom” Credentials type is selected.
      Password	Enter the proxy password. This field appears only when “Custom” Credentials type is selected.

   2. Click OK to save the proxy configuration.

      Note: If you run into connection issues with authenticated proxies, see the Licensing Troubleshooting article.

7. Click Validate, and when validation succeeds, click OK.
   

   You’re all set. Ranorex Studio will now start with your self-hosted subscription license.