# Kubernetes

{% hint style="info" %}
This plugin is part of Pro and Enterprise plan only
{% endhint %}

### **Introduction**

This guide provides instructions for integrating the [Rely.io](http://rely.io) Kubernetes plugin into your Kubernetes cluster. The integration involves two primary steps:

1. Retrieving the API token from [Rely.io](http://rely.io).
2. Installing the [Rely.io](http://rely.io) Kubernetes plugin using Helm.

### **Prerequisites**

* Access to your Kubernetes cluster via **`kubectl`**.
* Helm installed on your local machine or wherever you deploy Helm charts.

### **Step 1: Retrieve Your API Token**

#### **Obtaining the Token**

1. Navigate to Rely.io > Data Model > Plugins
2. Locate the OOTB plugin for Rely's Public API, click "View Details"
3. Hit "Generate an API key" which will copy a token onto your clipboard, you'll use it in the next step of this guide.

#### **Creating a Secret in Kubernetes**

Store the API token in your Kubernetes cluster as a secret.

```java
kubectl create secret generic relyio-api-token \\
  --namespace rely-integrations \\
  --from-literal=API_TOKEN="YOUR-API-TOKEN"
```

Replace `YOUR-API-TOKEN` with the actual API token you obtained from [Rely.io](http://rely.io).

### **Step 2: Install the** [**Rely.io**](http://rely.io) **Kubernetes Plugin**

#### **Adding the Helm Repository**

Add the [Rely.io](http://rely.io) plugin repository to your Helm setup. Please note that the repository endpoint provided below is a placeholder and should be replaced with the actual repository URL.

#### Command:

```bash
helm repo add relyio https://relyio-plugin-kubernetes-detech-ai-61649e8973c3604c946bff460f81.gitlab.io
```

#### **Installing the Plugin**

Install the [Rely.io](http://rely.io) Kubernetes plugin in your cluster under the **`rely-integrations`** namespace.

```bash
helm upgrade --install relyio-plugin-kubernetes \\
  relyio/relyio-plugin-kubernetes \\
  -n rely-integrations
```

### **Conclusion**

You have successfully integrated the [Rely.io](http://rely.io) Kubernetes plugin into your cluster and you should be able to see it in the "Plugins" page in Rely.

This plugin will enable your Kubernetes environment to communicate effectively with [Rely.io](http://rely.io) services. For any issues or further assistance, consult the provided links or contact support.
