Install PingFederate on Windows

  1. Request a license key via the Ping Identity licensing web page (

  2. Ensure you are logged on to your system with appropriate privileges to install and run an application.

  3. Verify that the Server JRE is installed and the required environment variables are set correctly (see Install Java).

    NoteIf you intend to use the PingFederate® installer for Windows or run PingFederate as a service, you must set the JAVA_HOME variable and modify PATH variable at the system level; otherwise, you have the options to set the variables at either the system or user level.
  4. Install PingFederate via the platform-specific installer or the distribution ZIP file.

    Installation medium Steps
    Platform-specific installer Download and run the PingFederate installer for Windows.

    PingFederate is configured to run as a service and started automatically at the end of the installation process.

    NoteThe PingFederate installer for Windows is designed to install only one instance of PingFederate on a Windows server. If you need additional PingFederate instances on the same Windows server, install them using the distribution ZIP file. Note that you must manually configure various port settings in the <pf_install>/pingfederate/bin/ file (for each instance) to avoid any port conflicts.
    Distribution ZIP file Download and extract the distribution ZIP file into an installation directory.
    NoteTo avoid future problems with automated upgrades, do not rename the installed pingfederate directory. If you are installing multiple instances of PingFederate on the same machine (for example, in certain server-clustering scenarios), either install each instance in a different location or rename the parent directory to install a parallel file structure in the same location.

    The installation directory is referred as <pf_install>, where the pingfederate directory can be found; for example, <pf_install>/pingfederate.

  5. If you have installed PingFederate by the distribution ZIP file, start PingFederate manually by running the following script:


    Wait for the script to finish—the startup process completes when this message appears near the end of the sequence:

    PingFederate running...

    TipTo configure PingFederate to run as a service, follow the steps in Install the PingFederate service on Windows manually.
NoteIf your organization requires compliance with FIPS 140-2 or plans on managing keys and certificates using a hardware security module (HSM), see Supported hardware security modules.

Tags Capability > Single Sign On; Hosting Environment > On-Premises; Operating System > Windows; Product > PingFederate > PingFederate 8.3; Product > PingFederate; Task Type > Installation