How to re-enable plugin upload in Jira Data Center
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles 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
Plugin upload from the Jira UI (upload app link) is disabled by default on Jira versions equal to or higher than 9.4.17, 9.12.4, 9.14.0, or any other Jira version with Universal Plugin Manager 6.1.9 or higher.
Details of this change can be found on:
JRASERVER-77129 - Getting issue details... STATUS
If you need to upload apps (as in environments not connected to Atlassian Marketplace), you can either re-enable this feature or upload the app directly to the nodes. All are shown below.
Environment
- Jira on versions equal to or higher than 9.4.17, 9.12.4, and 9.14.0; OR
- Jira on lower versions but using Universal Plugin Manager version 6.1.9 or higher.
Enable app upload with Java Virtual Machine (JVM) flag
The Jira administrator can enable the app upload by using the JVM flag "-Dupm.plugin.upload.enabled=true" (recommended method) or set the Jira to developer mode (only recommended for developers, as this can cause performance issues).
So, to enable the upload app link with the UPM flag, please perform the following in all nodes:
- Stop Jira.
Add the "-Dupm.plugin.upload.enabled=true" to the Jira settings.
For Linux, edit Jira_install_directory/bin/setenv.sh (example below).
JVM_SUPPORT_RECOMMENDED_ARGS="-Dupm.plugin.upload.enabled=true"
- For Windows, add the flag as seen here.
For Kubernetes/helm charts, edit the values.yaml and add the flag in the additionalJvmArgs.
# Specifies a list of additional arguments that can be passed to the Jira JVM, e.g. # system properties. # additionalJvmArgs: - "-Dupm.plugin.upload.enabled=true"
- Restart Jira.
Alternative: upload app JAR file manually
If, for security reasons, the Jira admin cannot enable the upload app through UI, the app still can be uploaded directly to the node plugin folder (more details here) as the following:
- Stop Jira.
- Copy your JAR file into the directory:
- If using non-clustered environment, to the <jira-nodelocal-home-folder >/
plugins/installed-plugins/
. - If using clustered environment (even if using only one node), to the <jira-shared-home-folder >/
plugins/installed-plugins/
.
- If using non-clustered environment, to the <jira-nodelocal-home-folder >/
- Start Jira.
- Confirm the installation by going to Administration > Manage Add-ons. The add-on should appear in the list as enabled.