---
title: "Install the Catchpoint data source | Grafana Enterprise Plugins documentation"
description: "Install the Catchpoint data source plugin in Grafana Cloud or self-managed Grafana."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# 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](/docs/plugins/grafana-catchpoint-datasource/latest/configure/) 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](/docs/grafana/latest/enterprise/license/activate-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](/docs/grafana/latest/upgrade-guide/).

## 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](/docs/grafana/latest/administration/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](/docs/grafana/latest/administration/plugin-management/#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 ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```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 ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```bash
GF_INSTALL_PLUGINS=grafana-catchpoint-datasource
```

For example, with Docker:

Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```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](/docs/grafana/latest/setup-grafana/installation/docker/).

### 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](/grafana/plugins/grafana-catchpoint-datasource/?tab=installation).
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](/docs/grafana/latest/administration/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](/docs/plugins/grafana-catchpoint-datasource/latest/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

- [Configure the Catchpoint data source](/docs/plugins/grafana-catchpoint-datasource/latest/configure/)
- [Catchpoint query editor](/docs/plugins/grafana-catchpoint-datasource/latest/query-editor/)