# EKS add-on

**groundcover's EKS add-on** is the easiest way to deploy the groundcover eBPF sensor on your EKS cluster, and connect it directly to your [BYOC observability data plane](https://docs.groundcover.com/architecture/byoc).

## Enable Add-on

### Namespace

Create groundcover namespace on your EKS cluster

```bash
kubectl create ns groundcover
```

### API Key Secret

Create groundcover API-key secret on your EKS cluster

```bash
# Install the groundcover CLI
sh -c "$(curl -fsSL <https://groundcover.com/install.sh>)"

# Login to your groundcover account
groundcover auth login

# Fetch your api key
groundcover auth print-api-key

# Create secret
API_KEY=<paste-api-key>
kubectl create secret generic api-key \
    -n groundcover \
    --from-literal API_KEY="${API_KEY}"
```

### Configuration Values

Create the following `agent-values.yaml` file and fill in the required values accordingly.

```yaml
global:
    ingress:
        site: <byoc-endpoint>
```

{% hint style="warning" %}
Your BYOC endpoint can be found in the [ingestion keys tab](https://app.groundcover.com/settings?selectedTab=ingestion-keys)
{% endhint %}

### Create Add-on

Run the following command to enable the groundcover agent add-on for your Amazon EKS cluster

<pre class="language-bash"><code class="lang-bash"><strong>aws eks create-addon \
</strong>    --region &#x3C;region> \
    --cluster-name &#x3C;cluster-name> \
    --addon-name groundcover_agent \
    --configuration-values 'file://agent-values.yaml'
</code></pre>

## Disable Add-on

Run the following command to disable the groundcover agent add-on for your Amazon EKS cluster.

```
aws eks delete-addon \
    --region <region> \
    --cluster-name <cluster-name> \
    --addon-name groundcover_agent
```
