This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.
Install a plugin
Besides the UI, you can use alternative methods to install a plugin depending on your environment or set-up.
Install a plugin using Grafana CLI
The Grafana CLI allows you to install, upgrade, and manage your Grafana plugins using a command line tool. For more information about Grafana CLI plugin commands, refer to Plugin commands.
Install a plugin from a ZIP file
This method is typically used for plugins not available in the Plugin Catalog or in environments without internet access.
Download the archive containing the plugin assets, and install it by extracting the archive into the plugin directory. For example:
unzip my-plugin-0.2.0.zip -d YOUR_PLUGIN_DIR/my-plugin
The path to the plugin directory is defined in the configuration file. For more information, refer to Configuration.
Install a plugin using Grafana configuration
Note
This feature requires Grafana 11.5.0 or later.
You can install plugins by adding the plugin ID to the plugins.preinstall
section in the Grafana configuration file. This prevents the plugin from being accidentally uninstalled and can be auto-updated. For more information, refer to
Configuration.
Install a plugin in air-gapped environment
Plugin installation usually requires an Internet connection. You can check which endpoints are used during the installation on your instance and add them to your instance’s allow list.
If this is not possible try installing a plugin using the Grafana CLI or as a ZIP file.
You can fetch any plugin from Grafana.com API following the download link referenced in the API.
Here’s an example based on grafana-lokiexplore-app
plugins.
- Open
https://grafana.com/api/plugins/grafana-lokiexplore-app
and look forlinks
section - Find a
download
url which looks something likehttps://grafana.com/api/plugins/grafana-lokiexplore-app/versions/1.0.2/download
- Use this URL to download the plugin ZIP file, which you can then install as described above.
Install plugins using the Grafana Helm chart
With the Grafana Helm chart, you can install plugins using one of the methods described in this section. All the YAML snippets install v1.9.0 of the Grafana OnCall App plugin and the Redis data source plugin. When installation is complete you’ll get a confirmation message indicating that the plugins were successfully installed.
Method 1: Use the plugins
field
Add the plugins you want to install as a list in your values file. For more information about the configuration, refer to the Helm chart configuration reference.
plugins:
- https://grafana.com/api/plugins/grafana-oncall-app/versions/v1.9.0/download;grafana-oncall-app
- redis-datasource
Method 2: Use GF_PLUGINS_PREINSTALL_SYNC
Add the following to your values.yaml
file:
env:
# Format: <plugin ID>@[<plugin version>]@<url to plugin zip>
GF_PLUGINS_PREINSTALL_SYNC: grafana-oncall-app@1.9.0@https://grafana.com/api/plugins/grafana-oncall-app/versions/v1.9.0/download
# Or without version and URL (latest version will be used)
# GF_PLUGINS_PREINSTALL_SYNC: grafana-oncall-app
# Multiple plugins (comma-separated)
# GF_PLUGINS_PREINSTALL_SYNC: grafana-oncall-app,redis-datasource
Method 3: Use GF_PLUGINS_INSTALL
(Deprecated since v12.1.0)
Add the following to your values.yaml
file:
env:
# Comma-separated list of plugin IDs
GF_PLUGINS_INSTALL: grafana-oncall-app,redis-datasource