T The Triage ManualTechnical Guides for IT Emergencies
P1 · Cloud & Hybrid Infrastructure

Kubernetes API Server Certificate Expired — Cluster Control Plane Down

Kubernetes cluster API server is unreachable because TLS certificates have expired. kubeconfig connections fail with x509 certificate has expired errors. Control plane components (scheduler, controller-manager, etcd) lose connectivity. Certificates generated by kubeadm default to 1-year expiry.

Indicators

Likely causes

Diagnostic steps

  1. From a control-plane node: kubeadm certs check-expiration — lists all cert expiry dates and flags expired certs
  2. Check system time on control-plane nodes: date && timedatectl status — ensure NTP is synced and all nodes agree
  3. Verify API server is running: crictl ps | grep kube-apiserver — if not running, check: journalctl -u kubelet -n 100
  4. Check API server manifest for cert paths: cat /etc/kubernetes/manifests/kube-apiserver.yaml | grep tls-cert
  5. Attempt renewal: kubeadm certs renew all — renews all control-plane certs; requires root on control-plane node
  6. After renewal, restart static pods: move manifests out of /etc/kubernetes/manifests/ then back in, or: systemctl restart kubelet

Resolution path

Prevention

Tools

kubernetesk8scertificatestlsx509kubeadmapi-servercloudpki