Install Coordimap Agent On Kubernetes

For Kubernetes environments, the recommended installation path is the maintained Coordimap Helm chart.

Useful references:

At the time of this docs update, Artifact Hub shows chart version 0.4.1.

Why Helm Is The Recommended Path

The Helm chart gives you a repeatable deployment with:

deployment and RBAC templates
values-driven configuration
better GitOps ergonomics
explicit image tag management
native support for Kubernetes Secrets and service accounts

Use raw YAML only as a fallback

Use the raw manifest approach when you need a one-off deployment or want to inspect the resources directly. For long-lived clusters, prefer Helm.

Prerequisites

Before installing, make sure you have:

A Kubernetes cluster.
Helm 3 installed.
kubectl configured for the target cluster.
A Coordimap API key.
A values file or agent config plan for your target data sources.

Install With Helm

The chart repository documents an OCI install flow based on GitHub Container Registry.

helm registry login ghcr.io
helm install coordimap-agent oci://ghcr.io/coordimap/charts/coordimap-agent \
  --version 0.4.1 \
  --namespace coordimap \
  --create-namespace \
  --set apiKey="YOUR_API_KEY"

For real environments, prefer a values file instead of inline secrets:

helm install coordimap-agent oci://ghcr.io/coordimap/charts/coordimap-agent \
  --version 0.4.1 \
  --namespace coordimap \
  --create-namespace \
  -f values.yaml

Prepare A Values File

The Helm chart supports upstream-native datasource configuration using dataSources entries.

Use the chart README and these docs together:

Verify The Deployment

kubectl get pods -n coordimap
kubectl logs deployment/coordimap-agent-agent -n coordimap

Raw YAML Fallback

If you need a manifest-based install, use the example here:

Kubernetes YAML Manifest