BeaverDeck logo
BeaverDeck

Home / BeaverDeck / Docs / Configuration Guide / Verify install

Verify a Successful Installation

Permissions: the operator running these checks needs Kubernetes access to the pod, Service, and auth Secret. The test user needs insights: view and pods: view in the selected namespace, while the ServiceAccount needs the corresponding Kubernetes read access.

Health Endpoint

GET /healthz is public and does not require authentication. A healthy BeaverDeck server returns HTTP 200 with {"status":"ok"}. The Helm chart uses this endpoint for both liveness and readiness probes by default. 

curl -fsS http://localhost:8080/healthz

This is a process-level HTTP health check. Continue with the Kubernetes resource checks below to confirm that the ServiceAccount can access the cluster APIs needed by BeaverDeck.

Installation Checklist

  1. Check that the pod is ready: kubectl -n beaverdeck get pods.
  2. Check health through the Service or port-forwarded URL: curl http://localhost:8080/healthz.
  3. Open the UI and complete initialization if the auth Secret is missing.
  4. Confirm the auth Secret exists: kubectl -n beaverdeck get secret beaverdeck-config.
  5. Open Node Insights and Workload Insights to confirm Kubernetes API access.
  6. Open a pod manifest and pod logs in a test namespace your role can access.