>fluxcd-notification-controller

fluxcd-notification-controller

Handles events and alerts in Flux, forwarding reconciliation results to external systems.

fluxcd

source-controller

helm-controller

argo-events

What is fluxcd-notification-controller?

The fluxcd-notification-controller image is part of the Flux GitOps toolkit. It manages notifications and alerts by watching for events from other Flux controllers, such as source-controller, kustomize-controller, and helm-controller.

It delivers reconciliation results and status updates to external systems like Slack, Microsoft Teams, Discord, GitHub, GitLab, or generic webhooks. Notification-controller also enables event-driven automation in Flux by triggering actions when certain conditions are met, such as a new Git commit or a Helm chart upgrade.

By centralizing event handling and alerting, it helps teams stay informed and respond quickly to changes in cluster state or delivery pipelines.

How to use this image

The fluxcd-notification-controller image is typically deployed as part of a Flux installation in Kubernetes.

Examples:

# Install Flux with notification-controller included
kubectl create ns flux-system
flux install --components=notification-controller

# Create a Provider for Slack
kubectl apply -f - <<EOF
apiVersion: notification.toolkit.fluxcd.io/v1beta3
kind: Provider
metadata:
  name: slack
  namespace: flux-system
spec:
  type: slack
  channel: general
  secretRef:
    name: slack-url
EOF

# Create an Alert that sends HelmRelease events to Slack
kubectl apply -f - <<EOF
apiVersion: notification.toolkit.fluxcd.io/v1beta3
kind: Alert
metadata:
  name: helm-alert
  namespace: flux-system
spec:
  providerRef:
    name: slack
  eventSeverity: info
  eventSources:
    - kind: HelmRelease
      name: '*'
EOF

This configuration sends HelmRelease reconciliation events to a Slack channel, giving visibility into deployments.

Image variants

The fluxcd-notification-controller image is typically released under ghcr.io/fluxcd/notification-controller and published in these forms:

notification-controller:<version>

Version-pinned images (e.g., notification-controller:v1.2.0) are recommended for production use.

notification-controller:latest

Tracks the most recent stable release. Useful for evaluation but not recommended for production.

notification-controller:main / nightly

Built from the development branch. Intended for contributors or teams testing upcoming features.

Interested in base images that start and stay clean?

Oops! Something went wrong while submitting the form.