Deployment

Kubernetes.

Reference Kubernetes manifests live under deploy/kubernetes/ for operators who want to self-host on a K8s cluster. Treat these manifests as a starting point — operators should adapt them to their environment.

STATUS: Reference
TYPE: Guide
STABILITY: Stable
REFERENCE: deploy/kubernetes/

Reference workloads

tenzro-validator   StatefulSet  N replicas  --role validator
tenzro-rpc         Deployment   1 replica   --role validator + RPC/MCP/A2A
caddy              Deployment   1 replica   PQ-hybrid TLS

Rolling

kubectl set image statefulset/tenzro-validator \
  tenzro-node=<registry>/tenzro-node:<tag> \
  -n <namespace>

kubectl rollout status statefulset/tenzro-validator \
  -n <namespace> --timeout=600s

Graceful exit

tenzro-node graceful-exit --rpc-url ... waits until the replica is not the elected HotStuff-2 leader for the next N views, then triggers shutdown. Suitable for preStop hooks.

Networking

Validators must have stable peer addresses. Use a Service per replica or hostNetwork for the libp2p port. Caddy fronts JSON-RPC, REST, MCP, A2A on the public subdomains.

Live testnet

For how the public testnet is actually operated, see the Docker and Testnet pages.

← All docs