---
title: Install the EKS add-on from AWS marketplace
source: https://docs.newrelic.com/docs/infrastructure/amazon-integrations/connect/eks-add-on
---

Amazon Elastic Kubernetes Service (Amazon EKS) is a managed Kubernetes service that makes it easy for you to run Kubernetes both on AWS and on-premises. Kubernetes is an open-source system for automating deployment, scaling, and management of containerized applications. This document walks you through the steps required to use the EKS add-on from AWS Marketplace.

## Prerequisites [#prereq]

-   An [Amazon Elastic Kubernetes Service (EKS)](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html) cluster. For more information, see our [Kubernetes integration: compatibility and requirements](https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/get-started/kubernetes-integration-compatibility-requirements/) and [Amazon's user guide](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html).
-   A valid New Relic account. You can subscribe to New Relic for free [from the AWS marketplace](https://aws.amazon.com/marketplace/pp/prodview-ov56chowabeb4?sr=0-3&ref_=beagle&applicationId=AWS-Marketplace-Console).
-   Subscribe to the [New Relic Kubernetes integration](https://aws.amazon.com/marketplace/pp/prodview-gcywa6keq2ajy?applicationId=AWS-Marketplace-Console&ref_=beagle&sr=0-5), also available for free.
-   Login to [New Relic](https://one.newrelic.com/) and generate a [license key](https://one.newrelic.com/api-keys).

> #### ⚠️ IMPORTANT
>
> This add-on is currently only supported on x86 instance types, with support for ARM64 coming soon.

## Provision the EKS add-on via the AWS console [#provision-k8s]

1.  Navigate to the **EKS Cluster > Add-Ons > Get More add-ons**.

    ![EKS Add On Tab.](https://docs.newrelic.com/images/EKS-Add-On-Screenshot-1.webp "eksAddOnTab.png")

2.  Under the AWS Marketplace add-on, search, browse or navigate to New Relic Kubernetes Integration, select the checkbox, and click **Next**.

    ![EKS Add On Marketplace.](https://docs.newrelic.com/images/EKS-Add-On-Screenshot-2.webp "eksAddOnMarketplace.png")

3.  Select the latest default version or choose an alternate version, if required, and click **Next**.

    ![EKS Add On Marketplace Config](https://docs.newrelic.com/images/EKS-Add-On-Screenshot-3.webp "eksAddOnMarketplaceConfig.png")

4.  Click **Create**.

Within a few minutes, New Relic's Kubernetes operator should activate and begin running. Please view the configuration steps below to collect and ship observability data from your EKS cluster to New Relic.

## Provision EKS add-on via the AWS CLI [#provision-cli]

Execute the following command to install the NewRelic add-on, with `--cluster-name` as the name of your EKS cluster.

```bash
   aws eks create-addon --cluster-name REPLACE_ME --addon-name new-relic_kubernetes-operator
```

You'll receive output similar to the following:

```bash
    {
        "addon": {
            "addonName": "new-relic_kubernetes-operator",
            "clusterName": "newrelic-test",
            "status": "CREATING",
            "addonVersion": "v0.1.8-eksbuild.1",
            "health": {
                "issues": []
            },
            "addonArn": "arn:aws:eks:ap-northeast-2:###############:addon/kubecon2023-127/new-relic_kubernetes-operator/6cc5e7b7-d8f1-5fa0-c668-2bc9727e16b3",
            "createdAt": "2023-07-27T11:47:57.023000-07:00",
            "modifiedAt": "2023-07-27T11:47:57.044000-07:00",
            "tags": {}
        }
    }
```

## Configure the Kubernetes operator [#configure-k8s]

You can confirm that the Kubernetes operator works by executing `kubectl get all -n newrelic` at the CLI. To start collecting metrics and ship to New Relic, use the following sample custom resource definition (CRD):

1.  Create a `crd.yml` file using the definitions below, with `spec.global.cluster` as the name of your EKS cluster and `spec.global.licensekey` as your New Relic license key.

    ```yml
    apiVersion: newrelic.com/v1alpha1
    kind: NRIBundle
    metadata:
      name: nribundle-sample
    spec:
      global:
        cluster: "<cluster>"
        licenseKey: "<licenseKey>"
        lowDataMode: true
      newrelic-infrastructure:
        enabled: true
        privileged: true
      kube-state-metrics:
        image:
          tag: "v2.10.0"
        enabled: true
      kubeEvents:
        enabled: true
      newrelic-prometheus-agent:
        enabled: true
        lowDataMode: true
        config:
          kubernetes:
            integrations_filter:
              enabled: false
    ```

2.  Once you have updated the desired configuration, upgrade the solution with the following command:

    ```
    kubectl apply -f crd.yml -n newrelic
    ```