Skip to main content
Question

Rundeck 5.19.0 integration with vault

  • July 27, 2026
  • 4 replies
  • 153 views

I recently opened a ticket for rundeck 5.10.0 integration with vault which got resolved but same is not working for rundeck 5.19.0 version 

 

In Rundeck version 5.10.0, I installed the Vault plugin by navigating to:

**Rundeck UI → Settings → Plugins → Find Plugins → Vault → Install**

I then uploaded Vault Storage Plugin version 2.0.1 from UI

https://github.com/rundeck-plugins/vault-storage/releases/download/2.0.1/vault-storage-2.0.1.jar

logged in to the Rundeck server, I replaced the existing plugin file by renaming the uploaded JAR:

```
mv vault-storage-2.0.1.jar vault-storage.jar
```

The Rundeck UI continued to show the Vault plugin as installed, and the integration worked as expected.


However, when I followed the same process in Rundeck version 5.19.0, it did not work. After running:

```
mv vault-storage-2.0.1.jar vault-storage.jar
```

the Rundeck UI showed that the Vault plugin needed to be installed.

Under **Key Storage**, I also received the following error:

```
Error: Cannot get property 'pluginGroupType' on null object
```


I then tried installing the Vault plugin available through the Rundeck UI. The installation completed without displaying any errors, but Rundeck was not able to read secrets from Vault.

When I tried to create a key in Rundeck Key Storage, I received the following error:

```
Encountered error while writing data to Vault.

Expecting HTTP status 204 or 200, but instead receiving 404.

Response body:
{"request_id":"86457168-9064537-89378-0987","lease_id":"","renewable":false,"lease_duration":0,"data":null,"wrap_info":null,"warnings":["Invalid path for a versioned K/V secrets engine. See the API docs for the appropriate API endpoints to use. If using the Vault CLI, use 'vault kv put' for this operation."],"auth":null}
```

Based on this error, it appears that the plugin installed through the Rundeck UI is using a KV version 1 API path instead of the required KV version 2 API path.

Because of this, I cannot use the plugin provided through the Rundeck UI. However, manually uploading Vault Storage Plugin version 2.0.1 causes the plugin registration issue described above.

How can I install and configure Vault Storage Plugin version 2.0.1 correctly in Rundeck 5.19.0 and resolve the following issues?

1. The Rundeck UI shows that the Vault plugin needs to be installed after the JAR file is renamed.
2. Key Storage displays the `pluginGroupType` null-object error.
3. The plugin installed through the Rundeck UI appears to use the incorrect Vault KV API path.

 

Thanks

4 replies

Forum|alt.badge.img
  • PagerDuty Team 📟
  • July 28, 2026

Hi!

Can you please try using that plugin under Rundeck 6 test environment? I’m pretty sure that plugin is focused on Rundeck 6 core (Java 17), so on Rundeck 5.19.0 the 2.0.1 JAR fails to load at startup. That's why the UI reports it as not installed, and the pluginGroupType error is Key Storage failing to render a provider whose plugin never loaded — not a separate bug. It worked on your 5.10.0 server most likely because that host runs Java 17.

If anything still fails, service.log from startup will show the exact plugin error — happy to take a look. 


  • Author
  • Contributor ✍️
  • July 28, 2026

Rundeck server - 5.10.0 

java -version

openjdk version "17.0.18" 2026-01-20 LTS

OpenJDK Runtime Environment (Red_Hat-17.0.18.0.8-1) (build 17.0.18+8-LTS)

OpenJDK 64-Bit Server VM (Red_Hat-17.0.18.0.8-1) (build 17.0.18+8-LTS, mixed mode, sharing)

 

readlink -f /proc/$(pgrep -u rundeck -f 'rundeck-.*\.war')/exe

/usr/lib/jvm/java-17-openjdk-17.0.18.0.8-1.el9.x86_64/bin/java

Rundeck server - 5.19.0

java -version
openjdk version "11.0.25" 2024-10-15 LTS
OpenJDK Runtime Environment (Red_Hat-11.0.25.0.9-1) (build 11.0.25+9-LTS)
OpenJDK 64-Bit Server VM (Red_Hat-11.0.25.0.9-1) (build 11.0.25+9-LTS, mixed mode, sharing)

 

readlink -f /proc/$(pgrep -u rundeck -f 'rundeck-.*\.war')/exe
/usr/lib/jvm/java-11-openjdk-11.0.25.0.9-7.el9.x86_64/bin/java

Is this the reason for the plugin issue?


Forum|alt.badge.img
  • PagerDuty Team 📟
  • July 28, 2026

Hi! Did you test using Rundeck 6 + Java 17? You’re using Rundeck 5.19 + Java 11.


  • Author
  • Contributor ✍️
  • July 28, 2026

Test environment: Rundeck 5.10 + Java 17 → plugin installation looks good. 
Prod environment: Rundeck 5.19 + Java 11 → issue with plugin installation

Couple of weeks ago we did upgrade our environment to Rundeck 5.19, so at this point we won’t upgrade to Rundeck 6.