/grafana-plugin-repository

The plugin repository for plugins that are published on grafana.com.

Primary LanguageJavaScript

Grafana Plugin Repository

This repository lists all officially supported Grafana plugins. Plugins in this repository are listed on Grafana.com, and can be installed locally using Grafana CLI or by Grafana Cloud users.

We review all plugins before they are published. This means that it may take some time before we can review your plugin.

Here's a few things you can do to help us review your plugin faster.

  • Validate your plugin release with this plugin validator
  • Use the GitHub workflows to automate your plugin release
  • Read the Review Guidelines before submitting your plugin. These guidelines determine if the plugin is ready to be published or not.
  • If possible, for datasource plugins please provide a description on how to set up a simple test environment. A docker container or simple install script helps speed up the review process a lot.

To submit a plugin for review:

  1. Fork this repository
  2. Add your plugin to repo.json
  3. Create a pull request

Note: Commercial plugins require a plugin subscription to be published. Commercial plugin subscriptions help us fund continued development of our open source platform and software. See the terms for more details.

Add a plugin to repo.json

To publish a plugin, add a new entry to the plugins array in repo.json.

Here's an example of a plugin release:

{
  "id": "briangann-gauge-panel",
  "type": "panel",
  "url": "https://github.com/briangann/grafana-gauge-panel",
  "versions": [
    {
      "version": "0.0.8",
      "url": "https://github.com/briangann/grafana-gauge-panel",
      "download": {
        "any": {
          "url": "https://github.com/briangann/grafana-gauge-panel/releases/download/v0.0.8/briangann-gauge-panel-0.0.8.zip",
          "md5": "782c973460f330287b7efca5486aa015"
        }
      }
    }
  ]
}

Plugin Release Schema

Property Description
id Plugin ID. Needs to match the plugin ID in plugin.json
type Plugin type, e.g. panel, datasource, or app
url URL to the plugin's GitHub project page
versions List of all published versions of the plugin

Plugin Version Schema

Property Description
version Plugin version. Needs to match the version in plugin.json
url URL to the plugin's GitHub project page
download Download information.

Plugin Download Schema

Property Description
url URL to a ZIP archive containing a production build of the plugin
md5 MD5 check sum of the ZIP archive

Resources