NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
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.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
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.3.0
docker.io/fluxcd/source-controller:v1.3.0ghcr.io/fluxcd/source-controller:v1.3.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: 2024-05-03
This minor release promotes the Helm APIs to GA, and comes with new features, improvements and bug fixes.
The HelmRepository API has been promoted from v1beta2 to v1 (GA).
The v1 API is backwards compatible with v1beta2.
For HelmRepository of type oci, the .spec.insecure field allows connecting
over HTTP to an insecure non-TLS container registry.
To upgrade from v1beta2, after deploying the new CRD and controller,
set apiVersion: source.toolkit.fluxcd.io/v1 in the YAML files that
contain HelmRepository definitions.
Bumping the API version in manifests can be done gradually.
It is advised not to delay this procedure as the beta versions will be removed after 6 months.
The HelmChart API have been promoted from v1beta2 to v1 (GA).
The v1 API is backwards compatible with v1beta2, with the exception
of the removal of the deprecated field .spec.valuesFile which was replaced with spec.valuesFiles.
The HelmChart API was extended with support for
Notation signature verification
of Helm OCI charts.
A new optional field .spec.ignoreMissingValuesFiles has been added,
which allows the controller to ignore missing values files rather than failing to reconcile the HelmChart.
The OCIRepository API was extended with support for
Notation signature verification
of OCI artifacts.
A new optional field .spec.ref.semverFilter has been added,
which allows the controller to filter the tags based on regular expressions
before applying the semver range. This allows
picking the latest release candidate
instead of the latest stable release.
In addition, the controller has been updated to Kubernetes v1.30.0, Helm v3.14.4, and various other dependencies to their latest version to patch upstream CVEs.
Improvements:
source.toolkit.fluxcd.io/v1 (GA)
#1428.spec.ignoreMissingValuesFiles to HelmChart API
#1447.spec.ref.semverFilter in OCIRepository API
#1407Fixes:
docker.io/fluxcd/source-controller:v1.2.5
docker.io/fluxcd/source-controller:v1.2.5ghcr.io/fluxcd/source-controller:v1.2.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: 2024-04-04
This patch release comes with improvements to the HelmChart name validation
and adds logging sanitization of connection error messages for Bucket sources.
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.2.4
docker.io/fluxcd/source-controller:v1.2.4ghcr.io/fluxcd/source-controller:v1.2.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: 2024-02-01
This patch release updates the Kubernetes dependencies to v1.28.6 and various other dependencies to their latest version to patch upstream CVEs.
Improvements:
docker.io/fluxcd/source-controller:v1.2.3
docker.io/fluxcd/source-controller:v1.2.3ghcr.io/fluxcd/source-controller:v1.2.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: 2023-12-14
This patch release updates the controller's Helm dependency to v3.13.3.
Improvements:
docker.io/fluxcd/source-controller:v1.2.2
docker.io/fluxcd/source-controller:v1.2.2ghcr.io/fluxcd/source-controller:v1.2.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: 2023-12-11
This patch release addresses an issue with AWS ECR authentication introduced in v1.2.0.
In addition, a variety of dependencies have been updated. Including an update of the container base image to Alpine v3.19.
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.2.1
docker.io/fluxcd/source-controller:v1.2.1ghcr.io/fluxcd/source-controller:v1.2.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: 2023-12-08
This patch release ensures the controller is built with the latest Go 1.21.x
release, to mitigate multiple security vulnerabilities which were published
shortly after the release of v1.2.0.
In addition, a small number of dependencies have been updated to their latest version.
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
docker.io/fluxcd/source-controller:v1.2.0
docker.io/fluxcd/source-controller:v1.2.0ghcr.io/fluxcd/source-controller:v1.2.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: 2023-12-05
This minor release comes with API changes, bug fixes and several new features.
A new field, .spec.prefix, has been added to the Bucket API, which enables
server-side filtering of files if the object's .spec.provider is set to
generic/aws/gcp.
Two new fields, .spec.verify.matchOIDCIdentity.issuer and
.spec.verify.matchOIDCIdentity.subject have been added to the HelmChart and
OCIRepository APIs. If the image has been keylessly signed via Cosign, these
fields can be used to verify the OIDC issuer of the Fulcio certificate and the
OIDC identity's subject respectively.
A new boolean field, .spec.insecure, has been introduced to the HelmRepository
API, which allows connecting to a non-TLS HTTP container registry. It is only
considered if the object's .spec.type is set to oci.
From this release onwards, HelmRepository objects of type OCI are treated as static objects, i.e. they have an empty status. Existing objects undergo a one-time automatic migration and new objects will be undergo a one-time reconciliation to remove any status fields.
Additionally, the controller now performs a shallow clone if the
.spec.ref.name of the GitRepository object points to a branch or a tag.
Furthermore, a bug has been fixed, where the controller would try to authenticate against public OCI registries if the HelmRepository object has a reference to a Secret containing a CA certificate.
Lastly, dependencies have been updated to their latest version, including an update of Kubernetes to v1.28.4.
Fixes:
OCIChartRepository.insecure to insecureHTTP
#1299Improvements:
go-git to v5.10.0
#1271.spec.insecure to HelmRepository for type: oci
#1288docker.io/fluxcd/source-controller:v1.1.2
docker.io/fluxcd/source-controller:v1.1.2ghcr.io/fluxcd/source-controller:v1.1.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: 2023-10-11
This patch release fixes a bug where OCIRepository objects can't be consumed when the OCI image layer contains symlinks.
Fixes:
Improvements:
docker.io/fluxcd/source-controller:v1.1.1
docker.io/fluxcd/source-controller:v1.1.1ghcr.io/fluxcd/source-controller:v1.1.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: 2023-09-18
This is a patch release that fixes a regression introduced in v1.1.0 where
HelmRepository objects would not be reconciled if they provided a TLS Secret
using .spec.secretRef with a type other than Opaque or kubernetes.io/tls.
In addition, the URL lookup strategy for Buckets has been changed from path to auto, to widen support for S3-compatible object storage services.
Lastly, several dependencies have been updated to their latest versions.
Fixes:
.spec.secretRef
#1225Improvements:
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.1.0
docker.io/fluxcd/source-controller:v1.1.0ghcr.io/fluxcd/source-controller:v1.1.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: 2023-08-23
This minor release comes with API changes, bug fixes and several new features.
All APIs that accept TLS data have been modified to adopt Secrets of type
kubernetes.io/tls. This includes:
.spec.secretRef has been deprecated in favor
of a new field .spec.certSecretRef.
This field is also supported by OCI HelmRepositories.caFile, keyFile and certFile keys in the
Secret specified in .spec.certSecretRef
have been deprecated in favor of ca.crt, tls.key and tls.crt.
Also, the Secret now must be of type Opaque or kubernete.io/tls..spec.secretRef using the ca.crt key, which takes precedence over the
existing caFile key.Furthermore, GitRepository has a couple of new features:
.spec.proxySecretRef
has been introduced which can be used to specify the proxy configuration to
use for all remote Git operations related to the particular object..spec.verification.mode
now supports the following values:
.spec.ref.spec.ref and the commit it
points to.Starting with this version, the controller now stops exporting an object's metrics as soon as the object has been deleted.
In addition, the controller now consumes significantly less CPU and memory when reconciling Helm repository indexes.
Lastly, a new flag --interval-jitter-percentage has been introduced which can
be used to specify a jitter to the reconciliation interval in order to
distribute the load more evenly when multiple objects are set up with the same
interval.
Improvements:
GitRepository
#1109.spec.certSecretRef for specifying TLS auth data
#1160spec.ref.name with Azure Devops
#1175Fixes:
docker.io/fluxcd/source-controller:v1.0.1
docker.io/fluxcd/source-controller:v1.0.1ghcr.io/fluxcd/source-controller:v1.0.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: 2023-07-10
This is a patch release that fixes the AWS authentication for cross-region ECR repositories.
Fixes:
fluxcd/pkg/oci to fix ECR cross-region auth
#1158One column per quarter.