How to Clear Jira's Plugin Cache in a Kubernetes Helm Chart Installation

Platform Notice: Data Center Only - This article only applies to Atlassian apps on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

This article provides instructions on how to clear Jira's plugin cache when running Jira in a Kubernetes environment using Helm Charts. Clearing the plugin cache can resolve issues related to inconsistent app behavior or problems with apps during startup.

Environment

Any Jira version on Kubernetes cluster deployed via the official Atlassian Helm Charts. 

Solution

Clearing Plugin Cache Using Helm Chart Configuration

  1. Add ATL_JIRA_CLEAR_PLUGIN_CACHE to Your Helm Values File:

In your Helm values file, set the ATL_JIRA_CLEAR_PLUGIN_CACHE environment variable to true. This will delete the plugin cache at ${JIRA_HOME}/plugins/.bundled-plugins and ${JIRA_HOME}/plugins/.osgi-plugins before Jira starts.

containers: - name: jira env: - name: ATL_JIRA_CLEAR_PLUGIN_CACHE value: "true"

2. Deploy the Updated Configuration:

helm upgrade <release-name> atlassian-data-center/jira --values <your-values-file>.yaml

Notes

  • This procedure automates the cache clearance, making it easier to manage in a Kubernetes environment.

  • Ensure you follow best practices for testing the changes in a staging environment before applying them to production.

References

Updated on March 11, 2025

Still need help?

The Atlassian Community is here for you.