Quarkiverse Hub

Edit this Page

Migrating to Quarkus 3.x: Manual upgrade

⚠ First have a look at the automated process described here, using the manual upgrade should be last resort.

If you’re not able to use the automation or some step is missed, you can manually move to the latest dependencies and patch up the code manually. But please take the time to report the issues you experienced to the Quarkus team so that they can improve the upgrade script appropriately.

Manual process, step 2: Update the Quarkus version

Update the Quarkus dependencies in your pom.xml to depend on the latest 3.x Quarkus. You can either

Using the release is recommended unless you need something in the snapshots.

To update the Quarkus version, update the property:


In the exceptional case that you are not using the platform BOM, the dependency would look like:


In Gradle, it would be:

implementation 'io.quarkus:quarkus-[your-dependency-here]:3.0.0.X'

Manual process, step 2: Get everything working

At this point, if you build, you should see a lot of failures. Resolving them will involve upgrading other dependencies to bring in versions which use Jakarta, and searching for javax.* references in the codebase.

Be aware that not all javax packages have been moved to Jakarta. (That's why using a tool is recommended.) The Jakarta Eclipse Transformer (which only changes the source code, not the POM) is an alternative to the OpenRewrite recipe.