This document is meant to help you migrate your application to Spring Security 6.0.

If you are using Spring Boot, consider reading theSpring Boot 3.0 Migration Guide.

Before you start the upgrade, make sure to upgrade to the latest available5.8.x version. This will make sure that you are building against the most recent dependencies of that line.

The5.8.x is a special release that was designed to help you to migrate to Spring Security 6.0. Spring Boot2.7.x, the latest release in the2.x line, does not use Spring Security5.8.x, because of that, you have tooverride the dependency versions manually.

There are several deprecations that were removed in 6.0 that should be replaced in5.8.x. To help with that, you can read thePrepare for 6.0 section of the documentation and apply the suggested changes.

After you upgraded to5.8.x and all the necessary changes were applied to your application by following thePrepare for 6.0 documentation, you are now ready to upgrade to 6.0.

If you are using Spring Boot, you shouldupgrade it to 3.0. Otherwise, you can follow the instructionshere.

After upgrading the dependency versions, please refer toMigrating to 6.0 to perform any remaining migration or cleanup steps.