How to fix Kubelet image GC failed in Kubernetes

KubernetesINTERMEDIATEMEDIUMUpdated Dec 7, 2025· 136 views

This error occurs when the kubelet garbage collection of container images fails, typically due to disk space or permission issues.

Quick fix

Fixes Kubelet image GC failed

  1. Check disk space
  2. Check kubelet logs
  3. Manually clean images
  4. Check permissions
  5. Configure GC policy
kubernetes — error
# Kubelet image GC failed
Kubelet image GC failed

What this error means

The "Kubelet image GC failed" error indicates that the kubelet cannot clean up unused container images.

Typical symptoms

  • Node disk fills up
  • GC logs show errors
  • Pod starts fail due to disk

Common causes

  1. Disk space exhausted
  2. Permission denied on image storage
  3. Image corruption

How to fix "Kubelet image GC failed"

1Check disk space

df -h /var/lib/kubelet

2Check kubelet logs

journalctl -u kubelet | grep -i gc

3Manually clean images

crictl rmi --prune

4Check permissions

ls -la /var/lib/kubelet/containers

5Configure GC policy

Edit kubelet config: imageGCHighThresholdPercent, imageGCLowThresholdPercent

Advanced notes

Default GC triggers at 85% disk usage, cleans until 80%. Adjust thresholds as needed.

Frequently asked questions

What does "Kubelet image GC failed" mean?
The "Kubelet image GC failed" error indicates that the kubelet cannot clean up unused container images.
How do I fix "Kubelet image GC failed"?
This error occurs when the kubelet garbage collection of container images fails, typically due to disk space or permission issues.
What causes "Kubelet image GC failed"?
Disk space exhausted Permission denied on image storage Image corruption
Is the "Kubelet image GC failed" error serious?
It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Official resources & further reading