How to Downgrade Local License for Testing


Last modified: March 9, 2021

Overview

Note:

The /var/cpanel/license.cfg file is available in cPanel & WHM version 84 and later.

This document provides steps to downgrade your server’s local license for testing purposes. You can use the file /var/cpanel/license.cfg to request a restricted cPanel & WHM license. This restricted license will benefit developers who would like to test custom code or experiment with user limitations.

The system uses the /var/cpanel/license.cfg file to determine the license request to downgrade your local license.

Note:

You cannot use this file to upgrade your license. To upgrade your license, contact cPanel Customer Service.

Downgrade your local license

To downgrade your local license for testing, perform the following steps:

  1. From the command line, log in to your cPanel & WHM server as the root user.

  2. Open the /var/cpanel/license.cfg file with your favorite editor.

  3. Edit the producttype and maxusers values to your desired settings. See the table below for more information.

  4. Save the file and refresh the license. To refresh the license, run the /usr/local/cpanel/cpkeyclt script.

Available values

Variable Type Description Possible values Example
producttype string A server profile.
  • databasenode — The Database profile.
  • dnsnode — The DNS profile.
  • dnsonly — The DNSOnly® mode.
  • mailnode — The Mail profile.
  • cloudlinux — The Cloudlinux Node profile
dnsnode
maxusers integer A numeric value. A positive integer that does not exceed the maximum user count for your license. 40

Additional Documentation