Skip to the content.

Versions

<- Back to Index

This page shows the additional information about our Versioning Policy and lifecycles.

Table of Contents

Versioning Policy

The major version of this project defines which spring-boot version we are compatible with.

The minor version defines the feature version of this project. Every time we bump spring-boot’s or gRPC’s version, we will also increment our feature version. The same applies if we add/change major features. In most cases you will not get any incompatibilities by upgrading, but since gRPC evolves just like its API, this cannot be ruled out. We try to minimize such influences, but can’t rule them out. If you don’t use advanced features, you won’t usually notice.

We usually don’t release patch versions, but include these patches in the next release. If you need a patched version, please open an issue.

Version Table

This table shows the spring and gRPC version that this library ships. In most cases you can upgrade to newer versions, but especially gRPC changes its API more frequently. Please report any issues to our repo.

Note

If you are using the non-shaded netty (and related libraries) please stick exactly to the version that is documented by gRPC. (grpc-netty-shaded avoids these issues by keeping these versions in sync.)

Version 3.x

Current version.

Version spring-boot spring-cloud gRPC Date
3.1.0 3.2.4 2023.0.0 1.63.0 Apr, 2024
3.0.0 3.2.2 2023.0.0 1.60.1 Feb, 2024

(* Future versions)

The listed dependency versions here are only used during the build process and may be replaced. grpc-spring-boot-starter is usually also compatible with newer or older versions than the listed ones. If you encounter an incompatibility with a newer version, please let us know so we can update this project!

Version 2.x

Version spring-boot spring-cloud gRPC Date
2.15.0 2.7.16 2021.0.8 1.58.0 Sep, 2023
2.14.0 2.6.13 2021.0.5 1.51.0 Nov, 2022
2.13.1 2.5.8 2020.0.5 1.42.2 Jan, 2022
2.13.0 2.5.7 2020.0.4 1.42.1 Nov, 2021
2.12.0 2.4.5 2020.0.2 1.37.0 Mai, 2021
2.11.0 2.3.8 Hoxton 1.35.0 Feb, 2021
2.10.1 2.3.3 Hoxton 1.31.1 Aug, 2020
2.10.0 2.3.3 Hoxton 1.31.1 Aug, 2020
2.9.0 2.3.1 Hoxton 1.30.0 Jun, 2020
2.8.0 2.2.7 Hoxton 1.29.0 Jun, 2020
2.7.0 2.2.4 Hoxton 1.27.1 Feb, 2020
2.6.2 2.2.1 Hoxton 1.25.0 Jan, 2020
2.6.1 2.2.1 Hoxton 1.25.0 Nov, 2019
2.6.0 2.2.1 Hoxton 1.24.2 Nov, 2019
2.5.1 2.1.6 Greenwich 1.22.2 Aug, 2019
2.5.0 2.1.6 Greenwich 1.22.1 Aug, 2019
2.4.0 2.1.5 Finchley 1.20.0 Jun, 2019
2.3.0 2.1.4 Finchley 1.18.0 Apr, 2019
2.2.1 2.0.7 ? 1.17.1 Jan, 2019
2.2.0 2.0.6 ? 1.17.1 Dec, 2018
2.1.0 2.0.? ? 1.14.0 Oct, 2018
2.0.1 2.0.? ? 1.14.0 Aug, 2018
2.0.0 2.0.? ? 1.13.1 Aug, 2018

Version 1.x

End of life - No more updates planned.

Version spring-boot gRPC Date
1.4.2 1.?.? 1.12.0 Jun, 2019
1.4.1 1.?.? 1.12.0 Jun, 2018
1.?.? N/A  

Upgrading Dependencies

If you upgrade any of the versions we strongly recommend doing so using a bom:

Release Notes

Refer to the release notes for more information on the changes for each version:


<- Back to Index