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 PingAuthorize 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 PingAuthorize Server root directory does not work in this case.

For information about how to specify the license with the Policy Editor, see Installing the PingAuthorize Policy Editor non-interactively.

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 PingAuthorize Server.

However, PingAuthorize Policy Editor fails to start if the license has expired.