Install PingFederate on UNIX/Linux

Refer to System requirements for a list of qualified UNIX and Linux operating systems.

  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.

    NoteYou must install and run PingFederate® under a local user account.
  3. Verify that the Server JRE is installed and the required environment variables are set correctly (see Install Java).

  4. 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. 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 Linux 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 > Linux; Product > PingFederate > PingFederate 8.3; Product > PingFederate; Task Type > Installation