NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #3112 by repository stars
Latest stable
v1.10.1
Last release 19 days ago
03 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
7 years old
516 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
docker.io/fluxcd/source-controller:v1.10.1
docker.io/fluxcd/source-controller:v1.10.1ghcr.io/fluxcd/source-controller:v1.10.1Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-10-26
This patch release hardens the controller's artifact server by setting a read header timeout, which also bounds the TLS handshake, and an idle timeout. As a result, connections that never send a request, or keep-alive connections from clients without an idle timeout, no longer stay open until the server shuts down. No timeout is set for reading or writing the whole request, so large artifacts can still be downloaded by slow clients.
Improvements:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
docker.io/fluxcd/source-controller:v1.10.0
docker.io/fluxcd/source-controller:v1.10.0ghcr.io/fluxcd/source-controller:v1.10.0Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-10-24
This minor release graduates object-level workload identity, now renamed to object identity, introduces SPIFFE mTLS between the controllers, and adds GitHub App Client ID support for Git repositories.
Object-level workload identity is now generally available and renamed to object
identity. Workload identity refers exclusively to identities assigned to Flux
controllers, while object identity refers to identities assigned to Flux
objects. The ObjectLevelWorkloadIdentity feature gate is retired and the
feature is always enabled.
⚠️ Breaking change: the default Flux RBAC no longer grants the create
verb on the serviceaccounts/token resource. If your installation relies on
the default RBAC, bind a ClusterRole with this permission to the controller
ServiceAccount before upgrading. See
fluxcd/flux2#6139 for the required
ClusterRole and ClusterRoleBinding, and the
object identity documentation
for the API reference.
Two credential providers can now supply the credential: kubernetes, which
uses the Kubernetes TokenRequest API and was already available, and spiffe,
which fetches a JWT-SVID from the SPIFFE Broker API. The provider is configured
on the ServiceAccount with credential.auth.fluxcd.io/provider, independently
of the service provider in .spec.provider.
This release introduces SPIFFE mTLS for inter-controller communication. Flux controllers authenticate each other with X.509-SVIDs, and each traffic type is enabled independently by configuring the SPIFFE Workload API socket and the SPIFFE IDs that the controller authorizes. See the inter-controller mTLS documentation for the controller flags and an example configuration.
GitHub App authentication accepts a Client ID as an alternative to the numeric
App ID (githubAppClientID). Signature verification is re-run when the trusted
keys rotate, so a revoked or replaced key no longer leaves a stale
SourceVerified=True condition.
Generic OCI repositories now support object identity. The credential is sent as
a bearer token, or as the password in HTTP basic authentication when
credential.auth.fluxcd.io/username is set. Audiences default to the registry
host and can be overridden with credential.auth.fluxcd.io/audiences.
Signature verification is re-run when the verification keys rotate, and the origin revision from OCI image metadata is forwarded in events.
A new .status.exportedInputs field exposes structured data extracted from the
source resource, for consumers such as ResourceSet to implement templating.
The controller is built with Kubernetes 1.37 and Go 1.27.
Fixes:
ap-southeast-6 region for Bucket sources
#2183Improvements:
generic OCI repositories
#2192spiffe credential provider and SPIFFE Broker API
#2197ObjectLevelWorkloadIdentity feature gate
#2197docker.io/fluxcd/source-controller:v1.9.6
docker.io/fluxcd/source-controller:v1.9.6ghcr.io/fluxcd/source-controller:v1.9.6Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-10-01
This patch release normalizes Azure Blob listing ETags so that the listing digest stays consistent with the stored artifact revision and unchanged containers are no longer re-downloaded on every reconcile, and evicts stale Helm repository index entries from the cache so that repositories with frequently changing indexes no longer fail with "Cache is full".
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.9.5
docker.io/fluxcd/source-controller:v1.9.5ghcr.io/fluxcd/source-controller:v1.9.5Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-08-31
This patch release upgrades Helm to v4.2.4 to stay in sync with helm-controller 1.6, which moved back from the Flux fork of Helm to upstream. It also updates the fluxcd/pkg dependencies, which bring Kubernetes to 1.36.4.
Improvements:
docker.io/fluxcd/source-controller:v1.9.4
docker.io/fluxcd/source-controller:v1.9.4ghcr.io/fluxcd/source-controller:v1.9.4Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-08-07
This patch release aligns Helm repository index loading with upstream Helm v4 by
skipping empty entries, improves the error handling in the Bucket reconciler
for optional fields in Azure responses, resolves OCI Helm charts by digest so
that verification and download operate on the same content, and limits GCS
static authentication to secrets holding service account keys. It also updates
the fluxcd/pkg dependencies, which align the ECR host detection with upstream.
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.9.3
docker.io/fluxcd/source-controller:v1.9.3ghcr.io/fluxcd/source-controller:v1.9.3Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-07-13
This patch release fixes the HelmChart CRD description for .status.url, which
was copy-pasted from Bucket and pointed users at BucketStatus.Artifact
instead of HelmChartStatus.Artifact.
Improvements:
docker.io/fluxcd/source-controller:v1.9.2
docker.io/fluxcd/source-controller:v1.9.2ghcr.io/fluxcd/source-controller:v1.9.2Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-07-07
This patch release disables Flux variable substitution on the source-controller
CRDs by annotating them with kustomize.toolkit.fluxcd.io/substitute: disabled,
so that Kustomizations with post-build substitution enabled no longer corrupt
the CRD schemas when they contain ${...} sequences. It also caches the
registry authorization token during Notation verification, so the token is
fetched once per verification instead of once per request, reducing
token-endpoint traffic against the registry.
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.9.1
docker.io/fluxcd/source-controller:v1.9.1ghcr.io/fluxcd/source-controller:v1.9.1Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-06-30
This patch release updates Kubernetes to 1.36.2 and the fluxcd/pkg dependencies, adds kubectl categories to the source-controller CRDs and documents the controller's command-line options.
Improvements:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
docker.io/fluxcd/source-controller:v1.9.0
docker.io/fluxcd/source-controller:v1.9.0ghcr.io/fluxcd/source-controller:v1.9.0Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-06-17
This minor release comes with new authentication and verification features for the source APIs, along with various improvements, fixes and dependency updates.
The GitRepository controller now supports AWS CodeCommit as a Git provider, allowing authentication to CodeCommit repositories.
Git commit and tag verification now supports SSH signatures in addition to
OpenPGP, so commits and tags signed with SSH keys can be verified via
.spec.verify.
The OCIRepository controller now supports configuring a custom Sigstore trusted root for keyless signature verification, via a Secret referenced in the verification configuration.
OCI artifacts are now resolved and stored strictly by their content digest.
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.8.5
docker.io/fluxcd/source-controller:v1.8.5ghcr.io/fluxcd/source-controller:v1.8.5Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-05-20
This patch release hardens path handling in the source reconcilers and updates
go-git to v5.19.1, which fixes
CVE-2026-45571 (crafted
repositories may modify the main and submodule .git directories) and
CVE-2026-45570 (improper
single-quote escaping in the SSH transport). It also fixes Helm chart
resolution for OCI tags that encode semver build metadata, updates Helm to
v4.2.0 to align with helm-controller, and adds support for GCP sovereign cloud
artifact registries via the fluxcd/pkg update.
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.8.4
docker.io/fluxcd/source-controller:v1.8.4ghcr.io/fluxcd/source-controller:v1.8.4Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-05-12
This patch release comes with dependency updates, including go-git v5.19.0 which fixes CVE-2026-45022.
Improvements:
docker.io/fluxcd/source-controller:v1.8.3
docker.io/fluxcd/source-controller:v1.8.3ghcr.io/fluxcd/source-controller:v1.8.3Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-04-21
This patch release updates go-git to v5.18.0, which includes performance improvements for Git operations, and comes with dependency updates.
Improvements:
docker.io/fluxcd/source-controller:v1.8.2
docker.io/fluxcd/source-controller:v1.8.2ghcr.io/fluxcd/source-controller:v1.8.2Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-04-07
This patch release fixes the Azure Blob prefix option not being passed to the storage client, and improves the error message when using encrypted SSH keys without a password.
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.8.1
docker.io/fluxcd/source-controller:v1.8.1ghcr.io/fluxcd/source-controller:v1.8.1Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-03-12
This patch release fixes Azure Container Registry authentication by using the ACR-specific auth scope instead of the generic registry scope.
Improvements:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
docker.io/fluxcd/source-controller:v1.8.0
docker.io/fluxcd/source-controller:v1.8.0ghcr.io/fluxcd/source-controller:v1.8.0Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2026-02-17
This minor release comes with Helm v4 support, cosign v3 verification, and various improvements.
⚠️ The v1beta2 APIs were removed. Before upgrading the CRDs, Flux users
must run flux migrate to
migrate the cluster storage off v1beta2.
The HelmChart controller now uses Helm v4. The HelmRepository type oci
has been moved to maintenance mode, users should migrate to OCIRepository.
CRD validation for v1 has been aligned with v1beta2 so that invalid
specs are rejected at admission time.
The OCIRepository controller now supports verifying artifacts signed with both cosign v2 and cosign v3.
The github provider now supports looking up the GitHub App installation ID
automatically, removing the need to configure it manually.
In addition, the Kubernetes dependencies have been updated to v1.35.0 and the controller is now built with Go 1.26.
Improvements:
source.toolkit.fluxcd.io/v1beta2
#1983HelmRepository type oci to maintenance mode
#1985docker.io/fluxcd/source-controller:v1.7.4
docker.io/fluxcd/source-controller:v1.7.4ghcr.io/fluxcd/source-controller:v1.7.4Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2025-11-19
This patch release fixes Azure Workload Identity in Azure China Cloud.
Improvements:
docker.io/fluxcd/source-controller:v1.7.3
docker.io/fluxcd/source-controller:v1.7.3ghcr.io/fluxcd/source-controller:v1.7.3Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2025-10-28
This patch release fixes support for SOCKS5 proxy in the controller APIs.
Fixes:
docker.io/fluxcd/source-controller:v1.7.2
docker.io/fluxcd/source-controller:v1.7.2ghcr.io/fluxcd/source-controller:v1.7.2Supported architectures: linux/amd64, linux/arm64 and linux/arm/v7.
The container images are built on GitHub hosted runners and are signed with cosign and GitHub OIDC. To verify the images and their provenance (SLSA level 3), please see the security documentation.
Release date: 2025-10-08
This patch release comes with various dependency updates.
The controller is now built with Go 1.25.2 which includes fixes for vulnerabilities in the Go stdlib: CVE-2025-58183, CVE-2025-58188 and many others. The full list of security fixes can be found here.
Improvements:
One column per quarter.