Operate OpenBao

Back up, upgrade, maintain, troubleshoot, recover, and restore an OpenBao cluster.

On this page

Prepare routine operations before you need an incident response. A supportable cluster has a proven snapshot and restore path, an upgrade policy, monitored conditions, and named owners for maintenance and recovery.

Choose a task

GoalStart here
Establish the production operating baselineReview production readiness
Create and retain Raft snapshotsBack up a cluster
Change the OpenBao versionUpgrade a cluster
Drain, scale, restart, or pause a clusterRun planned maintenance
Find the cause of a degraded serviceTroubleshoot a cluster
Delete a cluster intentionallyDecommission a cluster
Repair a sealed clusterRecover a sealed cluster
Repair leadership or quorumRecover from no leader
Continue after a failed blue-green rollbackRecover a failed rollback
Reintroduce state from a snapshotRestore a snapshot

Start every incident with status

Status is the operator’s latest observation. Events show how it got there. Inspect both before changing the cluster.

inspect

Collect the first cluster signals

kubectl -n <namespace> get openbaocluster <name> -o yaml
kubectl -n <namespace> get pods,pvc,services
kubectl -n <namespace> get events --sort-by=.lastTimestamp

Use the condition reason and message, not only status.phase. See Status and events for the observable contract.

Search the handbook

Try “install”, “threat model”, or “compatibility”.