Uninstalling Jenkins Enterprise FAQ

Q. How do I uninstall the trial version of Jenkins Enterprise?

A. The instructions for uninstallation vary depending on how you installed CloudBees Jenkins Enterprise, and what functionality you wish to have remaining after uninstallation.

  • If you used the “meta plugin” to upgrade a Jenkins installation to CloudBees Jenkins Enterprise then you do not need to change your jenkins.war.
  • On the other hand, if you downloaded a CloudBees Jenkins Enterprise WAR, you will need to replace that jenkins.war with the nearest equivalent Jenkins WAR file.
  • Finally, if you used one of the CloudBees Jenkins Enterprise native package installers (e.g. Windows, RPM, DEB, OS-X, etc), you will need to switch to the corresponding Jenkins package installer and potentially [change the update sources from which the native package installer pulls updates (primarily for the RPM and DEB installers)

The reason for the above, is that the CloudBees Jenkins Enterprise version of jenkins.war includes all the bundled plugins, and so if you remove any of the bundled plugins, they will be re-extracted every time Jenkins is installed, so you will find yourself unable to uninstall the licensed components.

When you start CloudBees Jenkins Enterprise with an expired license you will see the following screen:

To uninstall CloudBees Jenkins Enterprise you need to select the “Register later” option.

This screen may display a number of plugins prompting the display of the registration screen:

  1. The CloudBees License Manager is always present. If you click on the remove button Remove.png for the CloudBees License Manager you will completely remove all CloudBees Jenkins Enterprise licensed features.
    1. The CloudBees Jenkins Enterprise License Entitlement Check is present when you have CloudBees Jenkins Enterprise features in your Jenkins. If you click on the remove button for the CloudBees Jenkins Enterprise License Entitlement Check you will completely remove all CloudBees Jenkins Enterprise licensed features but retain the licensing features needed to support plugins that do not require a CloudBees Jenkins Enterprise license.
    2. The CloudBees Free License Entitlement Check is present if you had originally installed the Free plugins before trying out CloudBees Jenkins Enterprise. If you click on the remove button for the CloudBees Free License Entitlement Check you will remove only the entitlement check as the plugins requiring the Free license are also licensed by the Enterprise license and so will not be removed as long as one of the entitlement checks is present. Note: since you no longer have an Enterprise license, but you always have a free license it does not make sense to remove the free license entitlement check.

In most cases you will want to remove all the licensed plugins, in which case you will select the Remove button for the “CloudBees License Manager”. If you installed the CloudBees Free Plugins before you started an Enterprise trial then the recommendation is to just remove the CloudBees Jenkins Enterprise License Entitlement Check.

An alternative is to go to $JENKINS_HOME, delete plugins/cloudbees-*.jpi, plugins/nectar-*.jpi. When you reboot your Jenkins. You will be back to the open source version of Jenkins.

If you see error messages like “Failed Loading plugin xyz” during the bootup citing missing dependencies to cloudbees-license, you can also delete them (leaving them do not harm your Jenkins instance aside from that error message during a bootup.)

Q. I have uninstalled CloudBees Jenkins Enterprise, can I keep folders?

A. Yes; the CloudBees Folders plugin is open source, so your folders will remain. The CloudBees Folders Plus plugin is not, so any special customizations of folders (custom icon, environment variables, restricted children types, etc.) will be lost.

Q. What happens to Templates when I uninstall

A. Job and Folder templates will revert to standard Jobs and Folders (as the regular config.xml is generated for these jobs by the template plugin)

Build step and auxiliary templates will fail to load.

Have more questions?


Please sign in to leave a comment.