Kubernetes

Octopus is Kubernetes-first. The same binary you run with Docker can also run an in-process operator that watches the cluster and programs its own router — no sidecar and no separate control plane. It exposes dedicated health probes, drains gracefully on rolling updates, and discovers upstream Pods through the EndpointSlice API.

Two ways to install01

Both are documented under Kubernetes → Install.

• Helm (recommended) — a parameterized, upgradable install with RBAC, probes, autoscaling, a PodDisruptionBudget, and an optional ServiceMonitor:

  helm install octopus deploy/helm/octopus \
    --namespace octopus --create-namespace

• Raw manifests — a single kubectl apply for a Helm-free install, using the bundled deploy/kubernetes/octopus.yaml.

Routes, upstreams, plugins, and auth go under the chart's config value, which is rendered into a ConfigMap and mounted at /etc/octopus/config.yaml — the same file the container image expects.

What the Kubernetes section covers02

Deployment topics that apply in-cluster03