How to disable a plugin when Jenkins is down?

Issue

  • A plugin is preventing Jenkins to restart
  • I need to disable a plugin and Jenkins is down

Environment

Resolution

To disable a plugin via File System, create a file like <PLUGIN_ID>.jpi.disabled inside the $JENKINS_HOME/plugins folder. For example, to disable Green balls plugin, run:

touch $JENKINS_HOME/plugins/greenballs.jpi.disabled

References

Removing and disabling plugins page

Have more questions?

1 Comments

  • 0
    Avatar
    Steven Christenson

    ALL plugins that should be disabled should be managed like this while jenkins is not running - otherwise you have to restart jenkins once it comes up in order to disable them.  If you try, for example, to disable blueocean while Jenkins is running, you'll discover there are 26ish plugins that must be disabled in a particular order (and you'll still be left with two that can't be disabled...) but by doing it on the file system you do not need to care about order.

    Beware, however, that a disabled plugin will still elicit a "newer version is available" message in pluginManager - and accepting an upgrade WILL re-enable it.

    Finally, bundled plugins can't be uninstalled, you can only disable them.

Please sign in to leave a comment.