Troubleshooting & Runbooks

This section contains runbooks for diagnosing and resolving common issues on a running UDS Core platform. Each runbook covers a specific problem area: what to look for, how to identify the cause, and how to fix it.

If you’re setting up UDS Core for the first time, see How-To Guides instead.

Tip

Need help beyond these runbooks? Search UDS Core GitHub Issues for known issues. If your issue isn’t covered, open a new issue with relevant information attached.

Runbooks

Exemptions & Packages Not Updating Exemption or Package CRs not being applied or reflected in the cluster.

Keycloak Credential Recovery Recover lost or forgotten Keycloak admin credentials.

Resize Prometheus PVCs Resize Prometheus persistent volume claims when storage requirements increase.

Policy Violations Diagnose and fix admission failures, unexpected mutations, and stuck deployments caused by UDS policies.

Too Many Open Files Resolve too many open files / watcher create errors caused by low inotify or open file limits on the host.