How to Fix Jenkins Plugin Installation Failed Error

In this tutorial, you'll learn about How to Fix Jenkins Plugin Installation Failed Error. We cover key concepts, practical examples, and best practices.

The Problem

You try to install a Jenkins plugin from Manage Jenkins > Plugins and get Plugin installation failed or Failed to load: Plugin is missing: <dependency>(<version>). Jenkins cannot download the plugin due to network issues, dependency conflicts, or an outdated Jenkins version that doesn't support newer plugin metadata formats.

Quick Fix

1. Restart Jenkins and retry

# Restart via URL
curl -X POST http://jenkins:8080/safeRestart

# Or via systemd
sudo systemctl restart jenkins

2. Check the update center URL

Go to Manage Jenkins > Manage Plugins > Advanced > Update Site.

The URL should be:

https://updates.jenkins.io/update-center.json

If behind a proxy, configure it in Manage Jenkins > Manage Plugins > Advanced > Proxy Configuration.

3. Install the plugin manually (offline install)

# 1. Download the .hpi file
# From: https://plugins.jenkins.io/<plugin-name>
wget https://updates.jenkins.io/download/plugins/<plugin-name>/latest/<plugin-name>.hpi

# 2. Copy to the plugins directory
sudo cp <plugin-name>.hpi /var/lib/jenkins/plugins/

# 3. Restart Jenkins
sudo systemctl restart jenkins

4. Install dependencies first

The error message tells you which dependencies are missing. Install them in order:

# If it says "Plugin is missing: workflow-api(1308.v58d1ce849d6e)"
# Install the dependency plugin first

5. Fix certificate issues

# Download the Jenkins update center certificate
echo -n | openssl s_client -connect updates.jenkins.io:443 | openssl x509 > /tmp/jenkins-updates.crt

# Import into the Java keystore
sudo keytool -import -alias jenkins-updates \
  -keystore /etc/ssl/certs/java/cacerts \
  -file /tmp/jenkins-updates.crt

6. Update Jenkins

# Download the latest stable WAR
sudo systemctl stop jenkins
sudo wget https://get.jenkins.io/war-stable/latest/jenkins.war -O /usr/share/jenkins/jenkins.war
sudo systemctl start jenkins

7. Clear plugin cache

sudo rm -rf /var/lib/jenkins/plugins/*.lock
sudo rm -rf /var/lib/jenkins/updates/*.json

Then retry from the UI.

Common Causes

Prevention

• Update Jenkins before installing new plugins
• Check plugin dependency listings on the Jenkins plugin site before installation
• Use an internal plugin mirror in air-gapped environments
• Run java -jar jenkins.war --version to check your Jenkins version before troubleshooting