Installing on Microsoft Windows

CloudBees no longer supports CloudBees Jenkins Distribution as of February 24, 2021. Please refer to the following step-by-step documentation for Migrating from CloudBees Jenkins Distribution to Jenkins LTS. The increased alignment between CloudBees Jenkins Distribution and Jenkins means users will experience zero impact to Pipeline execution. Existing customers can also contact CloudBees Support to help ensure a smooth transition.

Please see About the CloudBees Jenkins Distribution retirement for more information.

To run CloudBees Jenkins Distribution on Microsoft Windows, use the MSI file from the CloudBees Jenkins Distribution download site.

  1. Download the cloudbees-jenkins-distribution.zip file, and the SHA256 checksum file.

  2. The checksum file can be used to verify that the cloudbees-jenkins-distribution.zip is correct. Compare the contents of cloudbees-jenkins-distribution.zip.sha256 with the output of the following PowerShell command:

    $(CertUtil -hashfile D:\Users\USER\Downloads\cloudbees-jenkins-distribution.zip SHA256)[1] -replace " ",""
  3. Unpack the archive and execute the CloudBees Jenkins Distribution installer, cloudbees-jenkins-distribution.msi.

    The CloudBees Jenkins Distribution installer for Microsoft Windows requires a 64-bit operating system and a compatible .NET framework (2.0, 3.5.1, 4.0) in order to be installed as a service. Most Microsoft Windows versions install a compatible framework by default.

After the process has completed, CloudBees Jenkins Distribution service should start automatically and be available in a web browser at localhost:8080 by default.