How to obtain a license

To obtain a license key, contact your account representative or use the Ping Identity licensing portal.

When do you need a license

A license is required for setting up a new single server instance and can be used site-wide for all servers in an environment. Additionally, you must obtain a new license when updating a server to a new major version, such as when upgrading from 7.3 to 8.0. When cloning a server instance with a valid license, you do not need a new license.


The update process displays a prompt for a new license.

How to specify a license

  • Specify a license at setup

    You have these options:
    • Use the --licenseKeyFile <path-to-license> option with setup.
    • Copy the license file to the server root directory and then run the setup tool. The tool discovers the license file.

  • Specify a license after setup

    Use the Administrative Console or dsconfig (in the Topology section, select License).
    Note: Placing the new license file in the server root directory does not work in this case.

How to view the license status

To view the details of a license, including its expiration, you have these options:
  • The server's status tool
  • The Administrative Console's Status page (On the Monitors tab, search for License.)

License expiration

The server provides a notification as the expiration date approaches.

Before a license expires, obtain a new one and install it by using dsconfig or the Administrative Console.


An expiring license causes alerts and alarms but does not affect the functionality of the product.