Documentationbreadcrumb arrow Pluginsbreadcrumb arrow Catchpointbreadcrumb arrow Install
Grafana Cloud Enterprise
Last reviewed: June 8, 2026

Install the Catchpoint data source

This document explains how to install the Catchpoint data source plugin. After you install it, refer to Configure the Catchpoint data source to connect it to your Catchpoint account.

The Catchpoint data source is an Enterprise plugin. It’s available with a Grafana Cloud Pro or Advanced plan and Grafana Enterprise.

Before you begin

Before you install the plugin, ensure you have:

  • A supported Grafana version: Grafana 11.6.7 or later.
  • A license: A Grafana Cloud Pro or Advanced plan or an activated Grafana Enterprise license.
  • Grafana permissions: Organization or server administrator role to install plugins on self-managed Grafana.

Required permissions

Installing a plugin requires elevated permissions:

  • Self-managed Grafana: A server administrator can install plugins with the Grafana CLI or by editing the configuration. An organization administrator can install plugins from the catalog in the UI.
  • Grafana Cloud: An Admin role on the stack is required to install plugins.

Version compatibility

The Catchpoint data source requires Grafana 11.6.7 or later. Before you install, confirm your Grafana version is supported:

  1. Click the help icon in the top navigation bar, or check Administration > General > Settings.
  2. Note the Grafana version number.
  3. If your version is older than 11.6.7, upgrade Grafana before installing the plugin. For upgrade guidance, refer to Upgrade Grafana.

Install in Grafana Cloud

In Grafana Cloud, Enterprise plugins are managed for you:

  1. In your Grafana Cloud stack, click Connections in the left-side menu.
  2. Click Add new connection.
  3. Type Catchpoint in the search bar.
  4. Select Catchpoint, then click Install.

Note

Plugins are automatically updated in Grafana Cloud, so you don’t need to upgrade the plugin manually.

Install on self-managed Grafana

On self-managed Grafana Enterprise, install the plugin from the plugin catalog or with the Grafana command line. For more information about the available methods, refer to Plugin management.

Use the plugin catalog

To install the plugin from the catalog:

  1. Click Administration > Plugins and data > Plugins in the left-side menu.
  2. Type Catchpoint in the search bar.
  3. Select Catchpoint.
  4. Click Install.

For more information about Enterprise plugins, refer to Install Grafana Enterprise plugins.

Use the Grafana command line

To install the plugin with the Grafana CLI, run the following command on the Grafana server, then restart Grafana:

Bash 
grafana cli plugins install grafana-catchpoint-datasource

After Grafana restarts, the Catchpoint data source is available to add.

Use an environment variable or Docker

For containerized or provisioned deployments, install the plugin with the GF_INSTALL_PLUGINS environment variable. Grafana installs the listed plugins on startup.

Bash 
GF_INSTALL_PLUGINS=grafana-catchpoint-datasource

For example, with Docker:

Bash 
docker run -d -p 3000:3000 --name=grafana \
  -e "GF_INSTALL_PLUGINS=grafana-catchpoint-datasource" \
  grafana/grafana-enterprise

For more information about running Grafana in Docker, refer to Run Grafana Docker image.

Install in an air-gapped environment

If your Grafana server can’t reach the internet, install the plugin manually:

  1. On a machine with internet access, download the Catchpoint plugin from the plugin catalog.
  2. Copy the plugin archive to the Grafana server and extract it into the Grafana plugins directory.
  3. Restart Grafana so it loads the plugin on startup.

For detailed steps, refer to Plugin management.

Update the plugin

Keep the plugin up-to-date so you have access to the latest features and fixes.

  • Grafana Cloud: Plugins are updated automatically. No action is required.
  • Self-managed Grafana: Update from the catalog by clicking Administration > Plugins and data > Plugins, selecting Catchpoint, and clicking Update. Alternatively, run grafana cli plugins update grafana-catchpoint-datasource and restart Grafana.

Grafana recommends running the latest Grafana version, which also applies to plugins.

Verify the installation

To confirm the plugin is installed:

  1. Click Administration > Plugins and data > Plugins in the left-side menu.
  2. Search for Catchpoint.
  3. Confirm the plugin appears and is marked as installed.

If the plugin doesn’t appear or fails to load, refer to Troubleshooting.

Uninstall the plugin

Before you uninstall the plugin, delete any Catchpoint data sources that use it. Dashboards and alert rules that query those data sources stop returning data after the plugin is removed.

  • Self-managed Grafana: Uninstall from the catalog by clicking Administration > Plugins and data > Plugins, selecting Catchpoint, and clicking Uninstall. Alternatively, run grafana cli plugins uninstall grafana-catchpoint-datasource and restart Grafana.
  • Grafana Cloud: Click Connections > Catchpoint, then uninstall the plugin from the plugin page.

Next steps