Which Jenkins LTS lines can go straight to 2.580.1

Rehearsed 2026-10-21 · 38 LTS lines · 100 and 300 plugins · 328 Jenkins starts

Short answer. If your controller is on 2.401.3 or newer, replacing only the war, the package or the image with 2.580.1 loaded all of the 300 most installed plugins. On 2.346.3 or older it never did without network access: plugins failed to load, and with 300 plugins 12 of those 21 lines did not start at all. Going in steps, through 2.346.3, 2.462.3 and 2.541.3 and changing Java on the way, loaded every plugin from every line. 2.580.1 needs Java 21, on the controller and on the agents.

New in 2.580.1. Jenkins 2.574 and 2.577 took the plugins that were split out of core out of the war. Before, an upgraded controller installed the ones it was missing from its own war. Now it has to get them from the update center. A controller older than 2.356 that cannot reach the update center comes up on 2.580.1 without instance-identity, and older ones also without sshd and the JavaMail plugins. If yours is offline, install those plugins before you replace the core.

How we tested

• Starting points: the last release of every LTS line from 2.60.3 (the oldest jenkins/jenkins image) to 2.568.3, 38 lines.
• Plugins: for each line, the 100 and the 300 plugins most installed on it in the Jenkins usage statistics (March 2026, 234,780 controllers), each at the newest release that line could load. The 38 lines cover 79.1% of those controllers.
• Rehearsals: every controller was started without network in the official image three ways: as it is, with only the core replaced by 2.580.1, and at every stop of the stepped path with the plugin versions for that stop. The upgrades start Jenkins as an upgrade from the previous version, not as a new install. A plugin counts as failing when Jenkins does not load it, and as loading partly when some of its extensions fail to load.

What we found

• Replacing only the core, 300 plugins: Jenkins did not start from 12 lines and started with failing plugins from 12 more. 13.6% of the reporting controllers are on those lines. With 100 plugins it always started, but 21 lines (10.8% of controllers) had failing plugins.
• Why: the logs show Jenkins failing to find classes from the plugins that used to come with the war, for example InstanceIdentity upgrading from 2.346.3 and the sshd module's SshCommandFactory from 2.277.4. Then Jenkins cannot inject the extensions that need them and stops. Which extension stops it varies between runs: Bitbucket Server Integration, Kubernetes Credentials Provider or Git.
• 2.89.4 to 2.150.3: about 120 of 305 plugins failed after a core-only upgrade, mostly on dependency cycles between plugins that were split out of core.
• In steps: with the plugin versions for each stop, plus the split-out plugins each stop needs, every line reached 2.580.1 with every plugin loaded, with 100 and with 300 plugins.
• The Java for a stop is not always the one you would pick. At the 2.346.3 stop the gradle plugin needs Java 11, not Java 8. The update center does not publish plugins' minimum Java; only the plugin's own manifest has it.

300 most installed plugins

100 most installed plugins

From 2.361.4 on, all 100 loaded before the upgrade, after a core-only upgrade and after the steps. The lines before it:

What this does not cover

• We tested without network. A controller that reaches the update center during the upgrade should download the split-out plugins itself, as the Jenkins changelog describes. We have not tested that.
• These are synthetic controllers: popular plugins, but no jobs, no configuration as code, no credentials and no agents. Your controller has pinned versions and plugins nobody else uses.
• 2.289.3 and 2.303.3 already fail before the upgrade, with about 100 plugins down on a dependency cycle around the credentials plugin. We have not seen that on a real controller, and it may come from picking the newest release of every plugin.
• 2.361.4 to 2.387.3 have blueocean-rest-impl loading partly before the upgrade too.
• Usage shares are from March 2026, so 2.555.3 and 2.568.3 show none.

Your own plugin list

Run this in Manage Jenkins → Script Console and send the output to hello@keelinfra.io:

Jenkins.instance.pluginManager.plugins.sort { it.shortName }.each { println "${it.shortName}:${it.version}" }

We run the same rehearsal with your plugins and your target version, and reply in writing: which stops your upgrade needs, which Java each one runs on, which plugins fail at which stop, and which split-out plugins to install first if the controller is offline. The first answer is free.