Home / BeaverDeck / Docs / User Guide / Troubleshooting

Common User Errors

Permission denied: check the application's permission matrix, role namespace scope, and Kubernetes ServiceAccount RBAC. All applicable layers must allow the operation.

Symptom	Likely cause	What to do
Namespace list is empty or an action says namespace is not allowed.	Your role namespace list or the app namespace policy does not include that namespace.	Ask an admin to review role namespace scope and `ALLOW_ALL_NAMESPACES`.
Exec button is disabled.	The pod is not ready/running, or the role lacks `exec: edit` or pod view permission.	Check pod state and role permissions.
Metrics columns show warning markers or dashes.	metrics-server, kubelet resource metrics, or GPU/DCGM metrics are not available.	Use Node or GPU Insights to confirm which metrics path is missing.
Google or OIDC sign-in succeeds but no role is assigned.	The external group values do not match any configured BeaverDeck group mapping.	Check the provider group claim or Workspace/Graph group values and update mappings.
Import Configuration fails.	The YAML is invalid, too large, contains a bad role/user/mapping, or references missing roles.	Fix the file and retry. Startup import errors also log the failed stage.