Install the Agent Runtime Operator

This guide walks you through installing the Agent Runtime Operator on your Kubernetes cluster.

Prerequisites

  • A running Kubernetes cluster

  • kubectl configured to target your cluster

Install with kubectl

Step 1: Install cert-manager

The Agent Runtime Operator requires cert-manager for webhook support:

# Install cert-manager (always pulls the latest release)
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/latest/download/cert-manager.yaml

# Wait for cert-manager to be ready
kubectl wait --for=condition=ready pod -l app.kubernetes.io/name=cert-manager -n cert-manager --timeout=60s

Browse all cert-manager releases at https://github.com/cert-manager/cert-manager/releases.

Step 2: Install the Agent Runtime Operator

# Install the operator (always pulls the latest release)
kubectl apply -f https://github.com/agentic-layer/agent-runtime-operator/releases/latest/download/install.yaml

# Wait for the operator to be ready
kubectl wait --for=condition=Available --timeout=60s -n agent-runtime-operator-system deployment/agent-runtime-operator-controller-manager

Browse all releases at https://github.com/agentic-layer/agent-runtime-operator/releases.

Install with Flux

If you are using Flux for GitOps, install the operator via its OCI repository:

apiVersion: source.toolkit.fluxcd.io/v1
kind: OCIRepository
metadata:
  name: agent-runtime-operator
  namespace: flux-system
spec:
  interval: 5m
  url: oci://ghcr.io/agentic-layer/manifests/agent-runtime-operator
  ref:
    semver: ">= 0, < 1"
---
apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata:
  name: agent-runtime-operator
  namespace: flux-system
spec:
  sourceRef:
    kind: OCIRepository
    name: agent-runtime-operator
  interval: 10m
  path: ./default
  prune: true
  wait: true
  dependsOn:
    # Ensure cert-manager is installed first (if you install it with Flux as well)
    - name: cert-manager

Verify the installation

# Check that the operator is running
kubectl get pods -n agent-runtime-operator-system

# Check that the CRDs are installed
kubectl get crd agents.runtime.agentic-layer.ai

You should see the operator pod running and the Agent CRD available.

What’s next