Back to blog

Java 17 usage in Documentation

Kevin Martens
Kevin Martens
August 1, 2023

Jenkins supports Java 17.

Jenkins has fully supported Java 17 since the 2.357 weekly release and 2.361.1 Long Term Support release. For this reason, we have transitioned to using Java 17 in the Jenkins user handbook. This includes the installation guides, Pipeline documentation, and Pipeline syntax. Refer to the GitHub issue for additional information and insight.


Debian 12 was released on June 10, 2023, and it no longer delivers OpenJDK 11. Due to this change in Debian, we have transitioned to using Java 17 in the documentation. The idea is this will encourage users to upgrade to Java 17, which has been fully supported since September 2022. Aligning with the actively supported Java version will also help prevent user confusion or frustration when trying to follow installation and usage guides.

Upgrading your Java version

While updating the documentation to reflect Java 17 support, we also added instructions on upgrading Jenkins' Java version from 11 to Java 17. This page includes a video walkthrough created by Darin Pope that guides users through the process of upgrading the Java version for Jenkins.

As always, update all installed plugins prior to and after updating Jenkins. This ensures up-to-date plugins that remain compatible. If plugins are not updated both before and after the upgrade, you can encounter compatibility issues.

About the author

Kevin Martens

Kevin Martens

Kevin Martens is part of the CloudBees Documentation team, helping with Jenkins documentation creation and maintenance.