Files
netbird-kubernetes-operator/docs/getting-started.md
T
Philip LaineandGitHub dd054d50ec Update documentation with refactored resources (#204)
This updates the documentation and examples to use the new resources. It
also adds automatic documentation creation for the api reference.

Signed-off-by: Philip Laine <philip.laine@gmail.com>
2026-04-24 16:22:04 +02:00

1.3 KiB

Getting Started

Prerequisites

Steps

Add the Helm repository.

helm repo add netbirdio https://netbirdio.github.io/kubernetes-operator

Install cert-manager, it is recommended so the Kubernetes API can communicate with the operator's admission webhooks. Skip this step if you already have cert-manager installed.

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.17.0/cert-manager.yaml

Create the NetBird namespace and API secret. The operator needs a NetBird personal access token to authenticate with the NetBird Management API.

kubectl create namespace netbird
kubectl -n netbird create secret generic netbird-mgmt-api-key --from-literal=NB_API_KEY=${ACCESS_TOKEN}

Install the Netbird operator.

helm install netbird-operator netbirdio/kubernetes-operator --create-namespace --namespace netbird

Verify the installation. All pods should be in a Running state before continuing.

kubectl get pods -n netbird

Once the operator is running, see the usage guide to start exposing services to your NetBird network.