---
title: Installing PingFederate on Linux systems
description: See System requirements for a list of qualified Linux operating systems.
component: pingfederate
version: 13.1
page_id: pingfederate:installing_and_uninstalling_pingfederate:pf_install_pf_on_linux_systems
canonical_url: https://docs.pingidentity.com/pingfederate/13.1/installing_and_uninstalling_pingfederate/pf_install_pf_on_linux_systems.html
llms_txt: https://docs.pingidentity.com/pingfederate/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: February 2, 2023
section_ids:
  before-you-begin: Before you begin
  about-this-task: About this task
  steps: Steps
  result: Result:
  next-steps: Next steps
  related-links: Related links
---

# Installing PingFederate on Linux systems

## Before you begin

* See [System requirements](pf_system_requirements.html) for a list of qualified Linux operating systems.

* [Generate a license key](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/pf_generate_new_license_key.html).

* Ensure you are signed on to your system with sufficient privileges to install and run an application. You must install and run PingFederate under a local user account.

* Verify that you have installed the Java Runtime Environment (JRE) and that you have set the required environment variables correctly. For more information, see [Installing Java](pf_install_java.html).

## About this task

To install PingFederate on a Linux system using the distribution `.zip` archive:

## Steps

1. Download the latest version of the PingFederate Server distribution `.zip` archive from the [Downloads website](https://www.pingidentity.com/en/resources/downloads/pingfederate.html).

2. Extract the archive into the target installation directory.

3. Start PingFederate manually by running `<pf_install>/pingfederate/bin/run.sh`.

   |   |                                                                                                 |
   | - | ----------------------------------------------------------------------------------------------- |
   |   | To configure PingFederate to run as a service on Linux, install PingFederate on Linux manually. |

   ### Result:

   The startup process is complete when you see the following message.

   ```
   PingFederate running...
   ```

## Next steps

If your organization plans to manage keys and certificates using a hardware security module (HSM), see [Supported hardware security modules](../getting_started_with_pingfederate/pf_supported_hardware_security_modules.html).

## Related links

* [memoryoptions and installation](../performance_tuning_guide/pf_memoryoptions_install.html)

* [Fine-tuning JVM options](../performance_tuning_guide/pf_fine_tuning_jvm_option.html)