Skip to main content

Backups

Zen Mesh state is split between the control plane (SaaS-managed) and your cluster (locally managed).

What Needs Backing Up​

Control Plane (Managed by Zen Mesh)​

Tenant configuration, API keys, destination settings, and delivery history are managed by Zen Mesh and automatically backed up. No action needed on your side.

Edge Plane (Your Responsibility)​

ResourceHow to Back Up
Helm valueshelm get values zen-agent -n zen-mesh > values-backup.yaml
zen-lock CRDskubectl get zenlocks -n zen-mesh -o yaml > zenlocks-backup.yaml
Adapter configsStored in dashboard — export via API

Restoring​

Helm Values​

helm upgrade --install zen-agent zenmesh/zen-agent \
  --namespace zen-mesh \
  -f values-backup.yaml

zen-lock CRDs​

kubectl apply -f zenlocks-backup.yaml
warning

Enrollment bundles cannot be restored — they are single-use and time-limited. If you lose your cluster, generate a new enrollment bundle from the dashboard.