How do I uninstall a plugin from Jenkins (Hudson)?

61.7k views Asked by At

I have a few plugins in my Jenkins installation which I no longer need. I've already disabled the plugins (and my build still work), and I'd like to remove the plugins completely. What is the right process for completely removing a Jenkins (Hudson) plugin?

5

There are 5 answers

8
Mark Rushakoff On BEST ANSWER

As mentioned by Jesse Glick in his answer, if you are using Jenkins 1.487 or higher, then there is a native way to uninstall plugins in the Jenkins UI. See JENKINS-3070 for details.

If you are using a version of Jenkins earlier than 1.487, then you can try manually uninstalling the plugin. As some people point out in the comments, this may not work on some platforms (in those cases, upgrade to at least 1.487 so that you can use the official uninstall feature).

To manually uninstall a plugin, stop Hudson/Jenkins, go to your HUDSON_HOME/plugins directory and remove both the .hpi file and the folder with the same name. So, if you were going to remove the CVS plugin, you would remove both the cvs.hpi file and the cvs directory.

After that, restart Hudson/Jenkins and the plugin won't be there anymore.

2
flip On

Hudson Plugins explains that some core plugins ("Tier 1" plugins, as they are called) are shipped with Hudson itself, and I assume cannot be deleted therefore.

0
Sampath On

You can disable it using the Jenkins ยป Plugin Manager. Go to Installed tab and untick the plugins you want to uninstall and restart Jenkins. Though it does not unintall, at least keeps it away from appearing from configuration pages..

1
Jesse Glick On

Jenkins 1.487 adds a UI for uninstalling plugins: JENKINS-3070

4
neoscribe On

Deleting the <plugin>.hpi file and corresponding <plugin>-plugin directory will effectively remove the plugin.

However, if you have configured parameters that belong to the plugin within your jobs your Hudson or tomcat logs may contain *CannotResolveClassException: hudson.plugins ... * exceptions because it attempts to load the plugin. This can result in build failures even if build is successful.

To fix that,

  • go to the job configuration and save it again. This should get rid of the plugin reference
  • if not, go into the hudson home jobs directory and open the config.xml found under the folder named after the job and remove the reference to the plugin
  • restart hudson