Popeye is a Kubernetes cluster resource sanitizer that scans live clusters to identify misconfigurations, stale resources, and deviations from best practices.
The tool addresses the challenge of tracking deployed resources and policies in growing Kubernetes environments by analyzing what is actually running in a cluster rather than examining manifests on disk. It performs linting across curated Kubernetes resource types, detecting issues such as port mismatches, unused resources, metric utilization problems, missing probes, container image concerns, and RBAC misconfigurations. When a metric-server is present, it also reports resource over- and under-allocation and warns of potential capacity exhaustion. Popeye operates in read-only mode and does not modify any cluster resources.
Popeye suits operators and platform teams managing live Kubernetes clusters who need visibility into configuration quality and resource health. It works best for teams that want to enforce best practices across their deployments and reduce operational overhead. The tool outputs results in multiple formats including console, JSON, and HTML, and can publish Prometheus metrics for integration with monitoring systems like Grafana.
The project receives most of its issue reports from external users rather than the core team, indicating a substantial adopter base providing real-world feedback. Response times to issues and pull requests often extend beyond several weeks. The issue tracker is primarily populated with questions, bug reports, and discussions about intended behavior.
