Flux - the GitOps family of projects

Flux is a set of continuous and progressive delivery solutions for Kubernetes that are open and extensible.

The latest version of Flux brings many new features, making it more flexible and versatile.

Flux is a CNCF Incubating project.

Get started
Terminal
              
            

Flux in short

🤝
Flux provides GitOps for both apps and infrastructure
Flux and Flagger deploy apps with canaries, feature flags, and A/B rollouts. Flux can also manage any Kubernetes resource. Infrastructure and workload dependency management is built in.
🤖
Just push to Git and Flux does the rest
Flux enables application deployment (CD) and (with the help of Flagger) progressive delivery (PD) through automatic reconciliation. Flux can even push back to Git for you with automated container image updates to Git (image scanning and patching).
🔩
Flux works with your existing tools
Flux works with your Git providers (GitHub, GitLab, Bitbucket, can even use s3-compatible buckets as a source), all major container registries, and all CI workflow providers.
🔒
Flux is designed with security in mind
Pull vs. Push, least amount of privileges, adherence to Kubernetes security policies and tight integration with security tools and best-practices. Read more about our security considerations.
☸️
Flux works with any Kubernetes and all common Kubernetes tooling
Kustomize, Helm, RBAC, and policy-driven validation (OPA, Kyverno, admission controllers) so it simply falls into place.
🤹
Flux does Multi-Tenancy (and “Multi-everything”)
Flux uses true Kubernetes RBAC via impersonation and supports multiple Git repositories. Multi-cluster infrastructure and apps work out of the box with Cluster API: Flux can use one Kubernetes cluster to manage apps in either the same or other clusters, spin up additional clusters themselves, and manage clusters including lifecycle and fleets.
📞
Flux alerts and notifies
Flux provides health assessments, alerting to external systems, and external events handling. Just “git push”, and get notified on Slack and other chat systems.
👍
Users trust Flux
Flux is a CNCF Incubating project and was categorised as "Adopt" on the CNCF CI/CD Tech Radar (alongside Helm).
💖
Flux has a lovely community that is very easy to work with!
We welcome contributors of any kind. The components of Flux are on Kubernetes core controller-runtime, so anyone can contribute and its functionality can be extended very easily.

Adopted by

Yad2 SisID MacPaw D2iQ Anchore AdoreMe QuickTable HybridK8s Aily Labs Autops SoulCycle Divid blackmirror media Rungway TietoEVRY Media­Markt­Saturn Grafana Labs Giant Swarm Stackspin Mintmesh VNClagoon Qualifio SAP SE Nexxiot identinet Liggo Crayon Mettle Weave Cloud FACEIT Canva J.B. Hunt Alea Axel Springer SE Maersk HMCTS Luminovo Syntasso Trendhim 23 Technologies GmbH Evrone Anova William & Mary Bink sngular SenseLabs 99 Group automotiveMastermind bimspot TraefikLabs Omaze FourteenFish Sage AI Labs iits-consulting EmploymentHero Xenit Volvo Cars Netrics FHE3 Virginia Tech orchit GmbH RingCentral Bedag Informatik AG NetHunt Quivr Cybrary particule. Cloudogu GmbH happn DKB Codefactory Sortlist Cookpad

Flux is a collection of tools for keeping Kubernetes clusters in sync with sources of configuration (like Git repositories), and automating updates to configuration when there is new code to deploy.

Declarative

Describe the entire desired state of your system in Git. This includes apps, configuration, dashboards, monitoring, and everything else.

Automated

Use YAML to enforce conformance to the declared system. You don’t need to run kubectl because all changes are synced automatically.

Auditable

Everything is controlled through pull requests. Your Git history provides a sequence of transactions, allowing you to recover state from any snapshot.

Designed for Kubernetes

Declaratively configurable using Custom Resources, state reports in the object’s status and via Kubernetes Events, and integrations with Kubernetes RBAC

Out-of-the-box integrations

Support for e.g. Kustomize, Helm; GitHub, GitLab, Harbor and custom webhooks; notifications to most team communication platforms; and many more.

Extensible

Easily create a continuous delivery solution with only the components you need, or use the GitOps Toolkit to extend Flux.

Some of the biggest organisations have adopted the Flux family of projects for their GitOps needs.

See who is part of our community and how about joining yourself?

The Flux project aspires to be the vendor-neutral home for GitOps in a Cloud Native world. What we achieved up until today is only possible because of our community.

GitHub Discussions

Join the conversation in GitHub Discussions. Everything Flux related ranging from specifications and feature planning to Show & Tell happens here.

Slack

If you want to talk to the Flux team and community in real-time, join us on Slack. This is a great way to get to know everyone. Get a Slack invite, or go to the #flux channel.

Mailing list

Join our (low-traffic) mailing list to stay up to day on announcements and sporadic discussions.

Our Team Calendar

The upcoming meetings, talks and community events in the next month are listed below. (All times are UTC.)

  • 2022-08-10
    12:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-08-11
    15:00
    CNCF Flux Project Meeting (late)
    Meeting agenda, minutes and videos: here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here
  • 2022-08-17
    12:00
    CNCF Flux Project Meeting (early)
    Meeting agenda, minutes and videos: here
    Join Zoom Meeting here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here
  • 2022-08-17
    16:00
    Cloud Native Live: VSCode & Flux: Testing the new (unreleased) OCI Repo Feature
    Cloud Native Live: VSCode and Flux: Testing the new (unreleased!) OCI Repository feature (virtual event) Wed, Aug 17, 9:00 AM (PDT) --------------------------------- REGISTER HERE ( here
    ) --------------------------------- The Flux project continues in active development with the addition of OCI configuration planned in the GA roadmap. Another Flux advancement has been the creation of the new VSCode Extension which provides a convenient interface to Flux that can help reduce friction moving between editor and terminal, alleviating the headache of context switching overloading developer focus. Flux maintainer Kingdon Barrett will demonstrate the pre-release of Flux's new OCI features and a convenient way to access them while they remain in pre-release so you can provide the feedback that is needed by Flux maintainers to make this feature a success! Speaker: Kingdon Barrett, Flux Maintainer and OSS Engineer at Weaveworks Kingdon is a FluxCD collaborator and one of the newest members of the DX team at Weaveworks. He is a long-time Helm enthusiast and Ruby/Go developer and works on the legendary cloud-native PaaS for Kubernetes, Hephy Workflow, in his fun time. His recent speaking engagements were Helm Summit 2019, GitOps Days 2020, KubeCon + CloudNativeCon EU 2021. --------------------------------- REGISTER HERE ( here
    ) --------------------------------- This event is part of the CNCF Online Programs ( here
    ) and hosted by CNCF ( here
    )
  • 2022-08-18
    17:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-08-24
    12:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-08-25
    15:00
    CNCF Flux Project Meeting (late)
    Meeting agenda, minutes and videos: here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here
  • 2022-08-31
    12:00
    CNCF Flux Project Meeting (early)
    Meeting agenda, minutes and videos: here
    Join Zoom Meeting here
    Meeting ID: 438 118 8348 One tap mobile +19292056099,,4381188348# US (New York) +13017158592,,4381188348# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) 877 853 5247 US Toll-free 888 788 0099 US Toll-free Meeting ID: 438 118 8348 Find your local number: here
  • 2022-09-01
    17:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308
  • 2022-09-07
    12:00
    The Flux Bug Scrub
    Join Zoom Meeting here
    Meeting ID: 858 2173 8864 Passcode: 660308

See this page for more detail and subscription options.

If you are new to Flux, you might want to check out some of the following resources to get started.

Find more on our dedicated resources page.

Flux CD v2 - Kubernetes GitOps (CNCFMinutes 20)

Flux CD v2 - Kubernetes GitOps (CNCFMinutes 20)

Saiyam provides an excellent introduction to Flux’s architecture and its powerful features with a quick demo of Bootstraping using FluxCLI.

Full GitOps Tutorial: Getting started with Flux CD

Full GitOps Tutorial: Getting started with Flux CD

Anaïs Urlichs walks you through getting started with Flux, installing the Starboard Helm Chart through GitOps best practices, managing your app, and setting up notifications and monitoring using Flux.

The FASTEST way to deploy apps to Kubernetes

The FASTEST way to deploy apps to Kubernetes

Techno Tim shows how Flux can be leveraged to monitor git repositories, source control, image container repositories, helm repositories, and more.

GitOps with GitHub Actions & Flux with Kingdon Barrett

GitOps with GitHub Actions & Flux with Kingdon Barrett

Kingdon Barret demos of GitHub Actions and three different methods for doing Flux deployment automation using SemVer with GitRepository Source, HelmRelease, and Image Update Automation.

Flux at GitOps Con, KubeCon, CloudNativeCon EU 2022

Flux at GitOps Con, KubeCon, CloudNativeCon EU 2022

A playlist with a compilation of all talks featuring Flux during GitOpsCon & KubeCon / CloudNativeCon EU 2022 (May 17 – 20).

GitOps Days 2022

GitOps Days 2022

Playlist from GitOps Days 2022 on June 8-9, 2022 featuring Flux integrators, end-users/adopters, and maintainers.

Flagger

Kubernetes Operator for the automation of promoting canary deployments using Istio, Linkerd, App Mesh, NGINX, Skipper, Contour, Gloo or Traefik routing for traffic shifting, and Prometheus metrics for canary analysis.

The canary analysis can be extended with webhooks for running system integration/acceptance tests, load tests, or any other custom validation.

Flagger

GitOps Toolkit

The set of APIs and controllers that make up the runtime for Flux. You can use the GitOps Toolkit to extend Flux, and to build your own systems for continuous delivery.

GitOps Toolkit

Flux v1 and Helm Operator

We owe our success and good reputation as GitOps project to Flux and Helm Operator. They are the v1 iteration of our project and currently in maintenance mode.

We strongly advise everyone to familiarise themselves with the latest version of Flux and start the process of migrating.

Flux v1 and Helm Operator