# Cyclops

Cyclops is a lightweight Kubernetes controller that acts as a backstop for cert-manager, sending a daily email or Slack report of certificates that are expired, were never issued, or are overdue for renewal, complete. It is open source and self-hosted, installable on Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/7762/cyclops

## Description

Cyclops is a lightweight Kubernetes controller that acts as a backstop for cert-manager, sending a daily email or Slack report of certificates that are expired, were never issued, or are overdue for renewal, complete with cert-manager's own failure reason. It reads Certificate resources directly, so no Prometheus or extra metrics stack is needed, and a healthy cluster stays quiet — a report only goes out when something needs attention.

## Platform availability

Available on 1 of 10 platforms: Helm.

## Health score

50/100 (Fair), based on 3 of 4 factors.
- Maintained: 88 (last commit 16 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- Kubernetes (Helm): https://artifacthub.io/packages/helm/cyclop/cyclops
- GitHub: https://github.com/sakshitposting-irl/cyclops
- Official website: https://dev.saksh.fyi/cyclops

## Common questions

### Which Cyclops pre-releases should I avoid for a first install?

Avoid v0.1.0-beta.3 through v0.1.0-beta.5 because they crash-loop on startup. The docs also recommend trying v1.0.3 in a non-production cluster first because the API is still v1alpha1.

### Do I need Prometheus for Cyclops certificate renewal alerts?

No. Cyclops reads cert-manager Certificate resources directly and sends a report when a certificate is expired, never issued, or overdue for renewal.

### How can I tell that a Cyclops report run failed?

A failed run shows ReportSucceeding=False on the CertReport and also creates a Warning Event.

### Is Cyclops Slack reporting ready for production use?

Slack incoming webhooks are supported from v0.1.0-beta.8, but Cyclops has not been run against real Slack yet. Use a non-production cluster first because Slack message limits are untested.

---
Source: Our Local Host (https://ourlocalhost.com/app/7762/cyclops), the self-hosted and open-source app directory.
