Install a plugin

{{< admonition type="note" >}}

Installing plugins from the Grafana website into a Grafana Cloud instance will be removed during the first half of 2026.

If you're a Grafana Cloud user, follow Install a plugin through the Grafana UI instead.

{{< /admonition >}}

Install a plugin through the Grafana UI

The most common way to install a plugin is through the Grafana UI.

1. In Grafana, click Administration > Plugins and data > Plugins in the side navigation menu to view all plugins.
2. Browse and find a plugin.
3. Click the plugin's logo.
4. Click Install.

You can use use the following alternative methods to install a plugin depending on your environment or setup.

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

{{< admonition type="note" >}} This feature requires Grafana 11.5.0 or later. {{< /admonition >}}

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.

1. Open https://grafana.com/api/plugins/grafana-lokiexplore-app and look for links section
2. Find a download url which looks something like https://grafana.com/api/plugins/grafana-lokiexplore-app/versions/1.0.2/download
3. 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: [email protected]@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