Skip to main content
This guide shows you how to deploy Odigos in your Kubernetes cluster using Argo CD with the official Odigos Helm chart. This allows for GitOps-based management and observability instrumentation across your applications.

​
Prerequisites

Before you begin, make sure you have:
  • A running Kubernetes cluster
  • Argo CD installed and configured in the cluster
  • Helm CLI installed (optional but useful for inspection and verification)

​
Step 1: Add the Odigos Helm Repository

Add the Odigos Helm repository to your Helm configuration: 
helm repo add odigos https://odigos-io.github.io/odigos --force-update
helm repo update

​
Step 2: Identify the Helm Chart Version

Check available versions of the Odigos chart to determine the desired targetRevision: 
helm search repo odigos --versions

​
Step 3: Define the Argo CD Application Manifest

Create an Argo CD Application custom resource to deploy Odigos using Helm. Save the following YAML as odigos-application.yaml: This guide shows you how to deploy Odigos in your Kubernetes cluster using Argo CD with the official Odigos Helm chart. This allows for GitOps-based management and observability instrumentation across your applications.

​
Prerequisites

Before you begin, make sure you have:
  • A running Kubernetes cluster
  • Argo CD installed and configured in the cluster
  • Helm CLI installed (optional but useful for inspection and verification)

​
Step 1: Add the Odigos Helm Repository

Add the Odigos Helm repository to your Helm configuration: 
helm repo add odigos https://odigos-io.github.io/odigos --force-update
helm repo update

​
Step 2: Identify the Helm Chart Version

Check available versions of the Odigos chart to determine the desired targetRevision: 
helm search repo odigos --versions

​
Step 3: Define the Argo CD Application Manifest

Create an Argo CD Application custom resource to deploy Odigos using Helm. Save the following YAML as odigos-application.yaml: 
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: odigos
  namespace: <ARGOCD_NAMESPACE>  # <- Replace with your Argo CD namespace
spec:
  project: default
  source:
    repoURL: https://odigos-io.github.io/odigos
    chart: odigos
    targetRevision:  # REQUIRED: set the version from 'helm search repo odigos --versions'
    helm:
      releaseName: odigos
      values: |
        # OPTIONAL: add your custom Helm values here if needed.
        # Argo CD expects this field to be a YAML-formatted string.
        # To use chart defaults, delete this field entirely or set it to an empty string ("").
  destination:
    server: https://kubernetes.default.svc
    namespace: <ODIGOS_NAMESPACE>  # <- Replace with the desired namespace where you want Odigos to be installed
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

​
Step 4: Apply the Application

Use kubectl to create the application in Argo CD: 
kubectl apply -f odigos-application.yaml
This will instruct Argo CD to deploy Odigos using the Helm chart.

​
Step 5: Monitor the Deployment

You can monitor the status of the deployment through the Argo CD UI:
  • Navigate to your Argo CD web interface.
  • Find the application named odigos.
  • Verify that it reaches a Healthy and Synced state.
Once complete, Odigos will be installed in your cluster and ready to instrument workloads.
⌘I