Documentationbreadcrumb arrow Pluginsbreadcrumb arrow GitHub data sourcebreadcrumb arrow Setupbreadcrumb arrow Install
Open source Enterprise Grafana Cloud

Install the GitHub data source plugin for Grafana

You can any of the following sets of steps to install the GitHub data source plugin for Grafana.

Install from plugin catalog

  1. Sign in to Grafana as a server administrator.
  2. Click Administration > Plugins and data > Plugins in the side navigation menu to view all plugins.
  3. Type GitHub in the Search box.
  4. Click the All in the State filter option.
  5. Click the plugin’s logo.
  6. Click Install.

Find more information about the plugin catalog.

Install from grafana.com

Install the plugin from the grafana.com plugins page using the instructions provided there. With this installation, you will get the latest published version of the plugin.

Install from GitHub

  1. Go to Releases on the GitHub project page.

  2. Find the release you want to install.

  3. Download the release by clicking the release asset called grafana-github-datasource-<VERSION>.zip. You may need to un-collapse the Assets section to see it.

  4. Unarchive the plugin into the Grafana plugins directory:

    On Linux or macOS, run the following commands to extract the plugin:

    Bash 
    unzip grafana-github-datasource-<VERSION>.zip
mv grafana-github-datasource /var/lib/grafana/plugins

    On Windows, run the following command to extract the plugin:

    powershell 
    Expand-Archive -Path grafana-github-datasource-<VERSION>.zip -DestinationPath C:\grafana\data\plugins

  5. Restart Grafana.

Install using grafana-cli

If you are using grafana-cli, execute the following command to install the latest published version of the plugin:

  1. Login to your machine as root user.

  2. On Linux or macOS, open your terminal and run the following command:

    Bash 
    grafana-cli plugins install grafana-github-datasource

    On Windows, run the following command:

    shell 
    grafana-cli.exe plugins install grafana-github-datasource

  3. Then restart Grafana.

Install custom version

If you need custom version of the plugin from GitHub, you can install it by running the following command:

Bash 
grafana-cli --pluginUrl <ZIP_FILE_URL> plugins install grafana-github-datasource

For example, to install version 1.6.0 of the plugin on Linux or macOS:

Bash 
grafana-cli --pluginUrl https://github.com/grafana/github-datasource/releases/download/v1.6.0/grafana-github-datasource-1.6.0.zip plugins install grafana-github-datasource

Or to install version 1.6.0 of the plugin on Windows:

powershell 
grafana-cli.exe --pluginUrl https://github.com/grafana/github-datasource/releases/download/v1.6.0/grafana-github-datasource-1.6.0.zip plugins install grafana-github-datasource