How to obtain a license

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

When 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 8.3 to 9.0. When cloning a server instance with a valid license, you do not need a new license.


The upgrade 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:

  • Use the server's status tool.
  • In the administrative console, go to the Status page and search for License on the Monitors tab.

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. For more information, see Upgrading a PingDirectory license.


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