You need to have System Administrator permissions in order to install and configure plugins.
Plugins are very powerful: they can change the behaviour of almost any part of the Confluence server. This makes it very important that you trust a plugin before you install it. To help ensure the authenticity of a plugin, always be aware of its origins and/or its creator. |
The Plugin Repository provides an easy way to install and configure plugins.
You need to have System Administrator permissions in order to install and configure plugins.
On this page:
When you click the name of a plugin in the plugin list, you'll be taken to the detailed view for that plugin.
General information and plugin module details are shown at the top of the display and from here you can disable or enable individual modules.
Note: Disabling a plugin module may cause other modules in the same plugin to cease to function correctly. When in doubt, make sure you disable or enable the entire plugin.
Near the bottom of the display a table outlines all plugin versions and shows which you have installed. Just like the plugins list, you can click the '+' to expand the details shown for a specific version.
This screen also allows you to quickly install, upgrade, downgrade and uninstall any version of the plugin.
There are various settings on the 'Admin' tab.
The most important of these is the 'Data Source' — without this, you'll see no plugins in the list and will get a fair number of errors.
The 'Earliest Plugin State' allows you to filter the plugin list to versions at or above a specific state: Alpha, Beta, Release Candidates, Stable. If you are running in a production environment, you will usually want to set this setting to 'Stable + Release Candidates' or 'Stable Only'.
The 'Plugin Compatibility' setting allows you to restrict the list to only show plugin versions that are specifically known to work with your version of Confluence.
In many cases, plugins will work with your version of Confluence, but they might be marked as 'unknown' compatibility if the plugin author hasn't been able to test with that specific Confluence version. As such, it's extremely useful if you find an 'unknown' version of a plugin to work (or not work) with your Confluence that you let us know (by any means possible) so that we can update the repository to reflect this.
The 'Category Visibility' setting allows you to trim down the categories list by hiding categories that don't contain a plugin yet.
There are several plugins that are not currently listed by the Plugin Repository which need to be manually uploaded either as a file or from a remote server URL.
If you want to install such a plugin:
Above we have described the 'Plugin Repository' screen in the Administration Console. For more information about these plugins, please refer to its page on the Atlassian Plugins Exchange site.
To find a specific plugin quickly on this site, ensure that you are in the Plugins section of this site and use the search tool. You should only need to enter a few keywords of the plugin's name to find it.
If the plugin repository connection times out, it's likely that there is a Web Proxy intermediary blocking the outbound connection. See Configure Web Proxy Support for Confluence for instructions how to configure.