---
title: Upgrading PingFederate
description: Use this section to learn how to upgrade your PingFederate environment to the latest version on Windows and Linux systems.
component: pingfederate
version: 13.1
page_id: pingfederate:upgrading_pingfederate:pf_upgrade_pf
canonical_url: https://docs.pingidentity.com/pingfederate/13.1/upgrading_pingfederate/pf_upgrade_pf.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: December 10, 2025
section_ids:
  upgrade-paths: Upgrade paths
  integration-kits: Integration kits
---

# Upgrading PingFederate

Use this section to learn how to upgrade your PingFederate environment to the latest version on Windows and Linux systems.

Depending on your PingFederate installation, you can upgrade by using the PingFederate installer for Windows or the Upgrade Utility, which automatically migrates existing PingFederate installations of 9.0 and later to the latest version. The Upgrade Utility is included with the software distribution.

Learn more about the updates to the latest version of PingFederate in [Upgrade considerations introduced in PingFederate 12.x](pf_upgrade_considerations_12x.html).

[Best Practices: Planning your upgrade](https://docs.pingidentity.com/solution-guides/best_practice_guides/htg_plan_software_upgrade.html) has general information about upgrading Ping Identity products and an upgrade planning guide.

|   |                                                                                                                                                                                                                                            |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|   | Learn how to reduce the downtime involved in upgrading PingFederate in [Performing a near-zero downtime PingFederate upgrade](https://docs.pingidentity.com/solution-guides/getting_started_guides/how_to_guides_near_zero_downtime.html). |

|   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | Before upgrading your production environment, you should:- Upgrade your test environment and verify that the new installation meets your expectations.

- Thoroughly retest the behavior of any customized components.After you complete the upgrade process, you can create a backup of your previous installation and remove it from the server.End users might experience service disruptions as you upgrade your PingFederate environment. As needed, schedule a maintenance window to perform the upgrade. |

## Upgrade paths

| Operating system  | Source version   | Source installation medium                       | Possible upgrade paths                                             |
| ----------------- | ---------------- | ------------------------------------------------ | ------------------------------------------------------------------ |
| Microsoft Windows | 9.x through 12.x | PingFederate installer for Windows               | PingFederate installer for Windows or PingFederate Upgrade Utility |
|                   | 9.x through 12.x | PingFederate product distribution`.zip` archive  | PingFederate Upgrade Utility                                       |
| Linux             | 9.x through 12.x | PingFederate product distribution `.zip` archive | PingFederate Upgrade Utility                                       |

|   |                                                                                                                                    |
| - | ---------------------------------------------------------------------------------------------------------------------------------- |
|   | If you're upgrading from PingFederate 8.x or earlier, contact [Support](https://support.pingidentity.com/s/) for more information. |

Both the PingFederate installer for Windows and the Upgrade Utility create a new installation based on the new product distribution `.zip` archive and then copy the relevant files and property values from the existing installation (the source) to the new installation (the target). As a result, neither tool affects the source installation.

## Integration kits

Both upgrade tools also copy the program files for the deployed adapters, connectors, and token translators (the integration kits in general) from the source installation to the target installation. Although the tools don't upgrade the integration kits automatically, you can download newer versions from the [Ping Identity Marketplace](https://marketplace.pingone.com) website and upgrade the integration kits manually. Learn more about specific integrations in the [Integrations documentation](https://docs.pingidentity.com/integrations/).