Server

How to upgrade to LTS 2025.0

Updated: April 17, 2025

Nuxeo LTS 2025 has breaking changes when you upgrade your project from a previous Nuxeo version.

You will find in this section how to upgrade your Nuxeo Server project with new Jakarta Standards and Nuxeo APIs.

How to Upgrade to Jakarta EE 10

The Java Specifications, formerly called Java EE, used in Nuxeo was upgraded to Jakarta EE 10 for LTS 2025.

This update has a significant impact on the Java code. As usual, upgrading from one major to another brings several breaking changes, but in addition to this, the package of the proposed APIs have changed from javax to jakarta.

More information on the Jakarta EE Page.

How to Upgrade to Jakarta RS 3 - WebEngine

While the upgrade to Jakarta RS 3 is part of the Jakarta EE 10 one, it has its own section because the implementation (Jersey), leveraged by Nuxeo WebEngine, has more changes.

Nuxeo WebEngine has undergone breaking changes to benefit from the new Jakarta RS additions.

More information on the Jakarta RS - WebEngine Page.

How to Upgrade Your REST tests

Firstly introduced in 2023.13 / 2023-HF23, the HttpClientTestRule has become the standard to test HTTP REST Endpoints.

Especially since the org.nuxeo.ecm.restapi.test.BaseTest class has been removed in LTS 2025 because it was tied to the Jersey Client library. As breaking changes were expected in Jersey, a complete rework of the BaseTest class into the HttpClientTestRule was done.

More information on the REST tests Page.

How to Upgrade Your Audit Contributions

The Nuxeo Platform Audit service has been heavily reworked for reliability, security and future improvements.

This refactoring maintains the backward compatibility with your existing code and contributions to Audit service, but we highly encourage you to upgrade to the new APIs.

More information on the Nuxeo Audit Service Page.