---
title: Upgrade considerations
description: The following modifications since PingFederate 13.0 might affect existing deployments.
component: pingfederate
version: 13.0
page_id: pingfederate:upgrading_pingfederate:pf_upgrade_considerations_13x
canonical_url: https://docs.pingidentity.com/pingfederate/13.0/upgrading_pingfederate/pf_upgrade_considerations_13x.html
revdate: December 5, 2025
---

# Upgrade considerations

The following modifications since PingFederate 13.0 might affect existing deployments.

* OAuth client management service response format

  If you use the in-place method to upgrade to PingFederate 13.0.3 or later, then the OAuth client management service will always return parameters that support multiple values as arrays, even when only a single value is returned.

  To return single values as strings:

  1. Open the `<pingfed-install>/pingfederate/server/default/data/config-store/com.pingidentity.ws.rest.oauth.client_management.model.converter.SerializerUtil.xml` file in a text editor.

  2. Set the `writeSingleItemElementAsArray` parameter to `false`.

  3. Save and close the file.

* Jersey version upgrade and plugin compatibility

  We've upgraded the internal Jersey library from version 1 to 2. As these versions aren't compatible, any plugin dependent on Jersey 1, such as the **OAuth Playground**, will cause PingFederate to fail to operate.

  If you have an older version of the **OAuth Playground** installed, you must either upgrade to OAuthPlayground 5.0, or delete the old OAuthPlayground from your deployment directory before starting PingFederate.

  If your `server.log` contains an error similar to the following error, review the `server/default/deploy` directory. You must update or remove any plugin that relies on Jersey 1.x libraries

  Example error

  ```
  java.lang.RuntimeException: java.lang.AbstractMethodError: Receiver class
  com.sun.jersey.api.uri.UriBuilderImpl does not define orinherit an
  implementation of the resolved method 'abstract javax.ws.rs.core.UriBuilder
  uri(java.lang.String)'...
  ```

* `pf.admin.baseurl` must be set

  A defect fix requires the `pf.admin.baseurl` property to be explicitly set in `run.properties`. This prevents admin console URL redirects from failing when PingFederate is accessed through a load balancer with a port that differs from `pf.admin.https.port`.

* Removed support for Java 11

  Starting with version 13.0, PingFederate no longer supports Java 11. Use Java 17 or Java 21 instead.

  Learn more in [Java environment](../installing_and_uninstalling_pingfederate/pf_system_requirements.html#java_environment).

* Upgrade from PingFederate 8.x

  Starting with version 13.0, PingFederate no longer supports upgrading from 8.x.