# Upgrading Spring Boot
Instructions for how to upgrade from earlier versions of Spring Boot are provided on the project wiki (opens new window). Follow the links in the release notes (opens new window) section to find the version that you want to upgrade to.
Upgrading instructions are always the first item in the release notes. If you are more than one release behind, please make sure that you also review the release notes of the versions that you jumped.
# 1. Upgrading from 1.x
If you are upgrading from the
1.x release of Spring Boot, check the “migration guide” on the project wiki (opens new window) that provides detailed upgrade instructions.
Check also the “release notes” (opens new window) for a list of “new and noteworthy” features for each release.
# 2. Upgrading to a new feature release
When upgrading to a new feature release, some properties may have been renamed or removed. Spring Boot provides a way to analyze your application’s environment and print diagnostics at startup, but also temporarily migrate properties at runtime for you. To enable that feature, add the following dependency to your project:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-properties-migrator</artifactId> <scope>runtime</scope> </dependency>
|Properties that are added late to the environment, such as when using |
|Once you finish the migration, please make sure to remove this module from your project’s dependencies.|
# 3. Upgrading the Spring Boot CLI
To upgrade an existing CLI installation, use the appropriate package manager command (for example,
If you manually installed the CLI, follow the standard instructions, remembering to update your
PATH environment variable to remove any older references.
# 4. What to Read Next
Once you’ve decided to upgrade your application, you can find detailed information regarding specific features in the rest of the document.
Spring Boot’s documentation is specific to that version, so any information that you find in here will contain the most up-to-date changes that are in that version.