---
title: "Helm"
slug: "helm"
updated: 2024-06-12T03:50:32Z
published: 2024-04-08T06:19:27Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://traceabledocs.document360.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Helm

Complete the following steps to install all the Traceable components using a helm chart. Traceable currently only supports Helm 3.

### Label Namespace

Make sure that you have gone through the prerequisites and other information available in the [Kubernetes](/docs/k8s) topic. Export token and Environment. You can obtain a token by completing the following steps:

1. Log in to your Traceable account.
2. Navigate to **Settings**(![image-1638268402925](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/image-1638268402925.png)) > **Account**> **Agent Tokens**.
3. Click on **Generate Token**.

Make sure to copy and save the generated token, as you cannot access it again. You can only edit or delete the name of the token. This token is used in the steps detailed below. If this token is deleted from Traceable Platform (UI), the communication between Traceable Platform agent and Traceable Platform (UI) will break. In such a case, generate and update a new token in the Platform agent.![traceable_generate_authentication_token](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/traceable_generate_authentication_token.png) Export Token and Environment:

> export TOKEN = <token> export ENV = <dev,test,stage,prod>

## **Install Traceable services**

Enter the following command to install Traceable services into your Kubernetes cluster.

Note:

Traceable supports only Helm 3.

1. Add Traceable repo. Enter the following command:ActionScriptActionScript 

```actionscript
helm repo add traceableai https://helm.traceable.ai
```
2. Update the repo. Enter the following command:ActionScriptActionScript 

```actionscript
helm repo update
```
3. Install Traceable agent. Enter the following command:ActionScriptActionScript 

```actionscript
helm install --namespace traceableai traceable-agent traceableai/traceable-agent --create-namespace --set token=$TOKEN --set environment=$ENV
```

### Load balance Platform agent

In a deployment where you have deployed more than one Traceable Platform agent, and you expect high span load, you load balance the spans among the Platform agents. Load balancing is available in Platform agent 1.26.0 and later and only applies to the Go agent. In Helm chart, add the following value:

`serviceType:Headless`

### Configurable registry suffix

You can configure registry suffix if you are using Helm chart to deploy Platform agent and use custom image registry. Use the `registrySuffix` field for configurable registry paths.

```actionscript
imageCredentials:
  registry: docker.io
  registrySuffix: traceableai
```

Using `registrySuffix` you can use a custom path, for example, `my-internal-docker.io/my-images/security-team/traceable-images/traceable-agent`. This option to have a custom path is available in Platform agent 1.27.2 and later.

### **Verify**

Enter the following command to verify a successful installation of Traceable agent:

```actionscript
kubectl get pod -n traceableai
```

The output should show 1/1 READY, similar to the following:

```actionscript
NAME                                     READY   STATUS    RESTARTS   AGE
traceable-agent-d8ff7cd79-qn2wb          1/1     Running   0          34m
```