Supported platforms for CloudBees Jenkins Platform

When using CloudBees Jenkins Platform, consult this page for supported platforms.

End-of-life announcement

The CloudBees Jenkins Platform (CJP) product which has been available since November 16, 2016, is reaching the end of its product lifecycle. CloudBees will declare this product end-of-life (EOL) on June 30, 2023.

Please note that once EOL is reached, CloudBees will no longer provide commercial support for this product. Please contact CloudBees Support if you have any concerns or questions.

Java support

The following sections detail Java support for CloudBees Jenkins Platform.

Supported Java application servers

For CloudBees Jenkins Platform, CloudBees recommends running it as a standalone application installed with one of the following:

java -jar jenkins.war or java -jar jenkins-oc.war
The native package for Red Hat (.rpm), Debian/Ubuntu (.deb) or Windows (.msi)

CloudBees also supports running CloudBees Jenkins Platform on Java application servers with the following requirements:

The WAR application must be the only web application running on the Java application server.
The restart capabilities of the application server must not be used; the instance must be restarted either via the JVM or using the instance’s built-in restart function.

CloudBees only supports two versions of Apache Tomcat and strives to support the latest GA version.

Application Server	Minimum Version	End Of Support
Apache Tomcat 8.0 and lower	Not supported	2017-03-01
Apache Tomcat 8.5	8.5.0
Apache Tomcat 9.0	9.0.0

Supported JDK versions

CloudBees supports only JDKs or JREs provided by either Oracle or OpenJDK for only the following versions:

Oracle JDK 11 - 64 bits
OpenJDK JDK 11 - 64 bits
Oracle JRE / JDK 8 - 64 bits ¹
OpenJDK JDK / JRE 8 - 64 bits ¹

¹ Support for Java 11 was added in version 2.332.1.4. CloudBees strongly recommends that you upgrade your CloudBees Jenkins Platform instance to Java 11 as soon as possible for the best experience.

In a future release, support for Java 8 will be discontinued and you will be unable to run new versions of the product on Java 8 going forward. Releases that occurred during the support window for Java 8 will continue to run on Java 8.

CloudBees Support may ask you to move forward to a specific update release (for example, _uXX) of a currently supported JDK/JRE version before diagnosing your problem. If you are running an outdated version of a supported JDK, CloudBees Support may ask you to move to a more recent JDK version since the more recent version may benefit from bug fixes and performance improvements. CloudBees recommends you keep your JDK version up-to-date.

Plugin compatibility

CloudBees endeavors to build plugins against the JDK that corresponds to the minimum Java requirements of the oldest supported CloudBees Jenkins Platform version.

CloudBees tests its binaries and plugins against the supported JDKs.

Some third party plugins may have different requirements which are outside of CloudBees control. Where a third party plugin is bundled within a CloudBees product, CloudBees endeavor to ensure that the plugins’ Java requirements are compatible with our supported Java versions.

Supported installation packages

CloudBees supports the usage of the CloudBees Jenkins Platform installation packages as described in the CloudBees Jenkins Platform installation documentation. CloudBees does not support running CloudBees proprietary plugins on open source distributions downloaded from other sources such as the Jenkins community. Consequently, CloudBees does not support the installation of proprietary plugins enabled by the CloudBees Jenkins Enterprise plugin which was deprecated in 2016.

Supported Docker environments

CloudBees supports running CloudBees Jenkins Platform in Docker containers, subject to the following constraints:

The Docker image must be the image provided by CloudBees: jenkins-enterprise, jenkins-operating-center for the CloudBees Jenkins Platform rolling release and jenkins-enterprise-fixed and jenkins-operations-center-fixed for the CloudBees Jenkins Platform fixe release
The Docker Engine used to run these containers must run on a Linux platform and must be a standalone Docker Engine provided by Docker, Inc. or by a Linux distribution provider (such as Red Hat or CentOS).
The Docker environment cannot be managed by a container orchestration tool or cluster manager such as Kubernetes, OpenShift, Docker Swarm, Mesos, or Amazon ECS.

Supported operating systems

CloudBees Jenkins Platform is supported on the following platforms as long as the operating system is actively supported by the vendor:

Debian
Red Hat Enterprise Linux
Ubuntu
CentOS
Fedora
openSUSE
Microsoft Windows

There are no universally applicable OS-level requirements. Some customers find that they need to increase the per-process open files limit on Linux (ulimit -n); or increase the maximum size of the Java heap or permanent generation (refer to JVM tuning guides for specifics).

Supported network filesystems

CloudBees does not support Microsoft CIFS/SMB network filesystems. This is due to known Java issues with file locking on CIFS that cause problematic behavior.

CloudBees supports the following versions of NFS:

NFS v.3.x
NFS v4.1 and higher

There are known performance issues with NFS v4.0. CloudBees supports NFS v4.1 and higher, but CloudBees does not support NFS v4.0.

High Availability plugin support

High Availability (HA) on a Windows environment is not supported.

Configuration as Code support in CloudBees Jenkins Platform

Configuration as Code is supported in CloudBees Jenkins Platform 2.222.4.3 (and higher).

Tier 1 and Tier 2 plugin support for Configuration as Code

The following plugins support Configuration as Code (CasC).

If you don’t see a plugin in this list, this can mean one of two things: that plugin does not support CasC or that plugin does not require configuration.

This list of plugins applies to CloudBees CI, CloudBees Jenkins Distribution, and CloudBees Jenkins Platform.

Table 1. List of plugins in CloudBees Assurance Program supporting Configuration as Code
Plugin Name	Minimum version	Configuration example
active-directory	2.16	https://github.com/jenkinsci/active-directory-plugin/blob/5b9401f6213a5fe24ef4bb0009cf7d8b644ff483/src/test/resources/hudson/plugins/active_directory/configuration-as-code.yaml
ant	1.10	https://github.com/jenkinsci/ant-plugin/blob/master/src/test/resources/hudson/tasks/configuration-as-code.yaml
antisamy-markup-formatter	1.6	https://github.com/jenkinsci/antisamy-markup-formatter-plugin/blob/master/src/test/resources/hudson/markup/configuration-as-code.yaml
artifact-manager-s3	1.1	https://github.com/jenkinsci/artifact-manager-s3-plugin/blob/master/src/test/resources/io/jenkins/plugins/artifact_manager_jclouds/s3/configuration-as-code.yml
aws-credentials	1.28	https://github.com/jenkinsci/aws-credentials-plugin/blob/2ae45df5330d9e64a574979736def83fa8dece0f/src/test/resources/com/cloudbees/jenkins/plugins/awscredentials/configuration-as-code.yaml
aws-global-configuration	1.4	https://github.com/jenkinsci/aws-global-configuration-plugin/blob/80f300120402cdd3bb9303c365260f80ef351ac0/src/test/resources/io/jenkins/plugins/aws/global_configuration/configuration-as-code.yaml
cloudbees-assurance	2.138.0.13	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-assurance-plugin/configuration-as-code.yml
cloudbees-bitbucket-branch-source	2.4.0	https://github.com/jenkinsci/bitbucket-branch-source-plugin/blob/master/src/test/resources/com/cloudbees/jenkins/plugins/bitbucket/endpoints/BitbucketEndpointConfigurationTest/configuration-as-code.yml
cloudbees-cache-step	1.1	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-cache-step/configuration-as-code.yml
cloudbees-cloudfoundry-cli	2.1.6	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-cloudfoundry-api-plugin/configuration-as-code.yml
cloudbees-cyberark-credentials	1.0.5	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-cyberark-credentials-plugin/configuration-as-code.yml
cloudbees-jenkins-advisor	3.0	https://github.com/jenkinsci/cloudbees-jenkins-advisor-plugin/blob/master/src/test/resources/com/cloudbees/jenkins/plugins/advisor/casc/configuration-as-code.yaml
cloudbees-monitoring	2.9	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-monitoring-plugin/configuration-as-code.yml
cloudbees-nodes-plus	1.20	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-nodes-plus-plugin/configuration-as-code.yml
cloudbees-pipeline-explorer	0.10	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-pipeline-explorer-plugin/configuration-as-code.yml
cloudbees-platform-insights	1.0	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-platform-insights-plugin/configuration-as-code.yml
cloudbees-plugin-usage	2.7	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-plugin-usage-plugin/configuration-as-code.yml
cloudbees-request-filter	1.7	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-request-filter-plugin/configuration-as-code.yml
cloudbees-ssh-slaves	2.7	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloudbees-ssh-slaves-plugin/configuration-as-code.yml
config-file-provider	3.4	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/config-file-provider
credentials	2.2.0	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/credentials
docker-commons	1.17	https://github.com/jenkinsci/docker-commons-plugin/blob/3186bed061262e8a40cde9038ac3f6661339ea6f/src/test/resources/org/jenkinsci/plugins/docker/commons/casc_symbols.yaml
docker-workflow	1.23	https://github.com/jenkinsci/configuration-as-code-plugin/blob/master/demos/docker-workflow/README.md
dockerhub-notification	2.5.0	https://github.com/jenkinsci/dockerhub-notification-plugin/blob/b635fd1979c47a8c8cc17a1635921dcc56ad9fca/src/test/resources/jcasc_symbols.yaml
electricflow	1.1.14	https://github.com/jenkinsci/electricflow-plugin/blob/master/src/test/resources/casc/configuration-as-code.yml
git	3.10.1	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/git
github-branch-source	2.5.8	https://github.com/jenkinsci/github-branch-source-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/github_branch_source/configuration-as-code.yaml
github	1.29.5	https://github.com/jenkinsci/github-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/github/config/configuration-as-code.yml
gitlab-branch-source	680.vc179a_1a_37915	https://github.com/jenkinsci/gitlab-branch-source-plugin/blob/2ae358978692543daa07fd25b40e49dc525f9eb0/src/test/resources/io/jenkins/plugins/gitlabserverconfig/casc/configuration-as-code.yml
google-compute-engine	4.3.0	https://github.com/jenkinsci/google-compute-engine-plugin/blob/develop/src/test/resources/com/google/jenkins/plugins/computeengine/configuration-as-code.yml
google-oauth	1.0.2	https://github.com/jenkinsci/google-oauth-plugin/tree/develop/src/test/resources/com/google/jenkins/plugins/credentials/oauth
gradle	1.30	https://github.com/jenkinsci/gradle-plugin/blob/master/src/test/resources/hudson/plugins/gradle/ConfigurationAsCodeTest/configuration-as-code.yml
jdk-tool	1.4	https://github.com/jenkinsci/jdk-tool-plugin/blob/9b72725d718a91bf1a57445652263f52e59bb984/src/test/resources/hudson/tools/casc.yaml
kube-agent-management	1.1.32	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/kube-agent-management-plugin/configuration-as-code.yml
kubernetes	1.25.3	https://github.com/jenkinsci/kubernetes-plugin/tree/master/src/test/resources/org/csanchez/jenkins/plugins/kubernetes/casc
kubernetes-credentials	0.7.0	https://github.com/jenkinsci/kubernetes-credentials-plugin/blob/be230e03b7d10f2a6925b64b5fe5acf4069d6593/src/test/resources/org/jenkinsci/plugins/kubernetes/credentials/configuration-as-code.yaml
ldap	1.16	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/ldap
mailer	1.25	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/mailer
master-provisioning-kubernetes	2.5.1	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/cloud-platform-master-provisioning-plugin/configuration-as-code.yml
matrix-auth	2.4	https://github.com/jenkinsci/matrix-auth-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/matrixauth/integrations/casc/configuration-as-code-v3.yml
metrics	4.0.2.4	https://github.com/jenkinsci/metrics-plugin/blob/master/src/test/resources/jenkins/metrics/configuration-as-code.yaml
nodejs	1.3.6	https://github.com/jenkinsci/nodejs-plugin/blob/2f2bb53821e36c36d4348e66bac5ff61474c76da/src/test/resources/jenkins/plugins/nodejs/configuration-as-code.yaml
notification-api	1.2	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/notification-api-plugin/configuration-as-code.yml
operations-center-webhooks	3.0.76	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/operations-center-webhooks/configuration-as-code.yml
pam-auth	1.6	https://github.com/jenkinsci/pam-auth-plugin/blob/master/src/test/resources/config.yaml
pipeline-maven	1333.v333b_b_f053972	https://github.com/jenkinsci/pipeline-maven-plugin/blob/master/pipeline-maven/src/test/resources/org/jenkinsci/plugins/pipeline/maven/configuration-as-code_mysql.yml
plain-credentials	1.5	https://github.com/jenkinsci/plain-credentials-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/plaincredentials/ConfigurationAsCode.yaml
saml	1.1.3	https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos/saml
script-security	1.64	https://github.com/jenkinsci/script-security-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/scriptsecurity/scripts/smoke_test.yaml
secure-requester-whitelist	1.4	https://github.com/jenkinsci/secure-requester-whitelist-plugin/blob/master/src/test/resources/org/jenkinsci/plugins/secure_requester_whitelist/CasCTest.yml
skip-plugin	4.6	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/skip-plugin/skipGroupsFolder.yaml
ssh-credentials	1.17	https://github.com/jenkinsci/ssh-credentials-plugin/blob/master/src/test/resources/com/cloudbees/jenkins/plugins/sshcredentials/jcasc/configuration-as-code.yaml
ssh-slaves	1.30.0	https://github.com/jenkinsci/ssh-slaves-plugin/blob/main/src/test/resources/hudson/plugins/sshslaves/SSHCasCConfig.yml
support-core	2.68	https://github.com/jenkinsci/support-core-plugin/blob/31ffccfe8004ac9f52d8cac813eba94d46e1bf61/src/test/resources/com/cloudbees/jenkins/support/configuration-as-code.yaml
trigger-restrictions	1.3	https://github.com/cloudbees/cloudbees-examples/tree/master/cloudbees-ci/configuration-as-code-examples/trigger-restrictions-plugin/labelLimits.yaml
timestamper	1.11.4	https://github.com/jenkinsci/timestamper-plugin/tree/5a129da1acf510c32582d7f4bfa4fb4fc4471b0e/src/test/resources/hudson/plugins/timestamper