NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #2416 by repository stars
Latest stable
v0.75.2
Last release 16 days ago
06 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
775 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
!AppVersion: v1.113.0 !AppVersion: v1.15.0
Release date: 12 Mar 2025
-controller.disableCacheFor="" flag from empty to configmap,secret and disables go-client cache for Secret and ConfigMap. See this issue for details.webhook and metricsserver TLS certificates. Reload logic was broken at v0.54.0. See related commit.Your coding agent can read these notes before it upgrades. Set up the MCP server →
FEATURE: vmoperator: Introduce possible labels breaking changes to kustomize configs. See this commit.
Release date: 11 Mar 2025
**Update note 1: remove deprecated fields Replicas, UpdateReplicas, AvailableReplicas and UnAvailableReplicas from vlogs, vmsingle,vmagent, vmalert objects .status.
Dependency: vmoperator: Updated default versions for VM apps to v1.113.0 version
Dependency: vmoperator: Updated default VLogs v1.15.0 version
Dependency: vmoperator: Updated Kubernetes libraries to v1.32.2 version and controller-runtime to v0.20.2 version.
Dependency: vmoperator: Updated client-gen to v0.32.4 version and generate api client. See this commit for details.
FEATURE: upgrade Go builder from Go1.23.4 to Go1.24. See Go1.24 release notes.
FEATURE: operator: add new field to CRD objects spec: disableAutomountServiceAccountToken. See this issue and this docs for details.
FEATURE: vmagent: deprecate aPIServerConfig in favor of apiServerConfig. aPIServerConfig will be removed at v0.56.0 release. See this issue for details
FEATURE: vmpodscrape: add portNumber to podMetricEndpoints. See this issue for details.
FEATURE: vmagent: support stream aggregation enableWindows.
FEATURE: vmagent: add RBAC access to /metrics/slis. See this issue for details.
FEATURE: vmoperator: Introduce possible labels breaking changes to kustomize configs. See this commit.
FEATURE: vmoperator: reduce config-reloader container resources.cpu.requests from 100m to 10m. And remove container resources.limits. See this issue for details. Thanks @xiaozongyang
BUGFIX: vmoperator: Properly generate kustomize config for validation webhook. See this commit.
BUGFIX: vmagent: reduce request latency for validation webhook. See this issue for details.
BUGFIX: vmuser: properly validate targetRef.crd.kind. Previously it incorrectly forbid VLogs reference. See this issue for details.
BUGFIX: vmoperator: reduce CPU and memory usage at large scale. Now operator could skip expensive runtime validation for VMRule and VMAlertmanagerConfig objects if -webhook.enable is set. See this issue for details.
Nothing published for this version
Nothing published for this version
!AppVersion: v1.110.0 !AppVersion: v1.6.1
Release date: 05 Feb 2025
SECURITY: upgrade Go builder from Go1.23.4 to Go1.23.5. See the list of issues addressed in Go1.23.5.
Dependency: vmoperator: Updated default versions for VM apps to v1.110.0 version
FEATURE: vmalertmanagerconfig: add thread_message_id to telegram_configs definition. It's supported by alertmanager v0.28.0+. See this issue for details.
FEATURE: vlogs: support VLogs in VMUser targetRefs.crd
BUGFIX: vmoperator: properly check Pod state during StatefulSet rolling upgrade procedure. See this issue for details.
BUGFIX: vmagent: properly upscale on shardCount change. See this issue for details.
BUGFIX: vmauth: properly apply vmuser changes. See this PR for details.
!AppVersion: v1.109.1 !AppVersion: v1.6.1
Release date: 21 Jan 2025
Dependency: vmoperator: Updated default versions for VM apps to v1.109.1 version
Dependency: vmoperator: Updated default version for VictoriaLogs app to v1.6.1 version
FEATURE: vmscrapeconfig: allow multiple values for zone at gceSDConfigs. See this issue for details.
FEATURE: vmoperator: decrease latency of generated configuration updates. Previously, configuration was update after status of child objects were changed. It could take significant time at large scale. See this issue for details.
FEATURE: vmoperator: reduce load on Kubernetes API server at prometheus-converter client.
FEATURE: vmoperator: change default value for client.qps=50 and client.burst=100 in order to improve operator performance on scale. See this issue for details.
FEATURE: vmoperator: add new flag controller.statusLastUpdateTimeTTL=1h to control staleness detection at status.conditions field. If operator serves large amount of object ( > 5_000) value for it should be increased.
FEATURE: vmoperator: add more context to the failed status with the reason and logs of crashed container. See this issue for details.
FEATURE: vmoperator: Properly expose service ports for VMServiceScrape generated for CRD objects by operator. Add -vmbackupmanager suffix to the VMServiceScrape job name and expose only well-known http port. See this issue for details.
BUGFIX: vmagent: properly build relabelConfigs with empty string values for separator and replacement fields. See this issue for details.
BUGFIX: converter: properly format regex single value expression at Prometheus Operator CRD relabelings and metricsRelabelings. See this issue for details.
BUGFIX: vmoperator: keep spec.template.annotations added by 3rd party tools, kike kubectl rollout restart. See this issue for details.
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
!AppVersion: v1.108.1 !AppVersion: v1.3.2
Release date: 8 Jan 2025
pods with statefulMode and shardCount defined.volumeMount for external storageDataPath volume.serviceAccount for requestsLoadBalancer Deployment. See this issue for details.Nothing published for this version
Nothing published for this version
BUGFIX: vmcluster and vmsingle: restore deprecated fields status.clusterStatus and status.singleStatus removed at v0.51.0. Those deprecated fields wil…
Release date: 23 Dec 2024
SECURITY: upgrade Go builder from Go1.23 to Go1.23.4. See the list of issues addressed in Go1.23.2 and Go1.23.3.
BUGFIX: vmoperator: keep resourceVersion and other significant metadata fields during update objects requests. See this issue for details.
BUGFIX: vmoperator: properly update updateStatus: failed field. It fixes excessive errors logging and amount of created Kubernetes Events.
BUGFIX: vmoperator: Properly rollback incorrect object configuration. Previously diff for objects could be calculate incorrectly and update request could be skipped.
BUGFIX: vmcluster and vmsingle: restore deprecated fields status.clusterStatus and status.singleStatus removed at v0.51.0. Those deprecated fields will be removed at upcoming v0.52.0 version.
Nothing published for this version
Update note 1: `labels` and `annotations` inheritance is deprecated and will be remove at upcoming `v0.52.0` release. It's recommend to move all neede…
Release date: 19 Dec 2024
Update note 1: labels and annotations inheritance is deprecated and will be remove at upcoming v0.52.0 release. It's recommend to move all needed labels and annotations to the spec.managedMetadata fields.
Operator will preserve annotations, but any changes to it will be ignored. labels inherited from CRD.metata.labels will be removed after upgrade to v0.52.0.
Update note 2: VMAuth.spec.unauthorizedAccessConfig is deprecated in favour of VMAuth.spec.unauthorizedUserAccessSpec. Operator still serves deprecated fields until v1.0 release.
Update note 3: The following fields: [default_url,tlsConfig,discover_backend_ips,headers,response_headers,retry_status_codes,max_concurrent_requests,load_balancing_policy,drop_src_path_prefix_parts] are deprecated at VMAuth.spec. in favour of VMAuth.spec.unauthorizedUserAccessSpec. Operator still serves deprecated fields until v1.0 release.
"app.kubernetes.io/part-of": "vmcluster" label to the objects generated for VMCluster components. It helps to use labels selectors to identify objects belong to the cluster.spec setting unauthorizedUserAccessSpec that replaces unauthorizedAccessConfig and inlined fields from VMUserConfigOptions. See this issue for details.src_headers, src_query_args and discover_backend_ips in the generate vmauth config when specified under vmuserSpec.targetRefs.dump_request_on_errors to vmuser.spec. See this PR for details.annotations to the PodDisruptionBudget and HorizontalPodAutoscaler objects generated.vmagentSpec.ScrapeConfigSelector and vmagentSpec.scrapeConfigNamespaceSelector when vmagentSpec.selectAllByDefault=false. Previously, the VMScrapeConfig could be ignored.xxxNamespaceSelector when vmagentSpec.selectAllByDefault=true. See this doc for detailed rules.license.forceOffile and license.reloadInterval options. See this doc for the details.securityContext to the containers with useStrictSecurity: false. See this issue for details.containers with enabled useStrictSecurity: true. It sets privileged: false.msg body, change logger field to properly display controller.CRD name. See this issue for details.managedMetadata to VMCluster.spec, VMAgent.spec,VMAlert.spec, VMAuth.spec,VMAlertmanager.Spec, VMSingle.spec andVLogs.spec. It controls labels and annotations added to the objects created operator (such as Deployment). See this issue for details.replace directive from go.mod.status sub-resource for VMUser, VMAlertmanager, VMRule and VMScrape.* objects. Add new conditions field, that represents resources conditions. See this issue for details.Update note 1: `labels` and `annotations` inheritance is deprecated and will be remove at upcoming `v0.52.0` release. It's recommend to move all neede…
Release date: 19 Dec 2024
Update note 1: labels and annotations inheritance is deprecated and will be remove at upcoming v0.52.0 release. It's recommend to move all needed labels and annotations to the spec.managedMetadata fields.
Operator will preserve annotations, but any changes to it will be ignored. labels inherited from CRD.metata.labels will be removed after upgrade to v0.52.0.
Update note 2: VMAuth.spec.unauthorizedAccessConfig is deprecated in favour of VMAuth.spec.unauthorizedUserAccessSpec. Operator still serves deprecated fields until v1.0 release.
Update note 3: The following fields: [default_url,tlsConfig,discover_backend_ips,headers,response_headers,retry_status_codes,max_concurrent_requests,load_balancing_policy,drop_src_path_prefix_parts] are deprecated at VMAuth.spec. in favour of VMAuth.spec.unauthorizedUserAccessSpec. Operator still serves deprecated fields until v1.0 release.
"app.kubernetes.io/part-of": "vmcluster" label to the objects generated for VMCluster components. It helps to use labels selectors to identify objects belong to the cluster.spec setting unauthorizedUserAccessSpec that replaces unauthorizedAccessConfig and inlined fields from VMUserConfigOptions. See this issue for details.src_headers, src_query_args and discover_backend_ips in the generate vmauth config when specified under vmuserSpec.targetRefs.dump_request_on_errors to vmuser.spec. See this PR for details.annotations to the PodDisruptionBudget and HorizontalPodAutoscaler objects generated.vmagentSpec.ScrapeConfigSelector and vmagentSpec.scrapeConfigNamespaceSelector when vmagentSpec.selectAllByDefault=false. Previously, the VMScrapeConfig could be ignored.xxxNamespaceSelector when vmagentSpec.selectAllByDefault=true. See this doc for detailed rules.license.forceOffile and license.reloadInterval options. See this doc for the details.securityContext to the containers with useStrictSecurity: false. See this issue for details.containers with enabled useStrictSecurity: true. It sets privileged: false.msg body, change logger field to properly display controller.CRD name. See this issue for details.managedMetadata to VMCluster.spec, VMAgent.spec,VMAlert.spec, VMAuth.spec,VMAlertmanager.Spec, VMSingle.spec andVLogs.spec. It controls labels and annotations added to the objects created operator (such as Deployment). See this issue for details.replace directive from go.mod.status sub-resource for VMUser, VMAlertmanager, VMRule and VMScrape.* objects. Add new conditions field, that represents resources conditions. See this issue for details.Update note 1: `labels` and `annotations` inheritance is deprecated and will be remove at upcoming `v0.52.0` release. It's recommend to move all neede…
Update note 1: labels and annotations inheritance is deprecated and will be remove at upcoming v0.52.0 release. It's recommend to move all needed labels and annotations to the spec.managedMetadata fields.
Operator will preserve annotations, but any changes to it will be ignored. labels inherited from CRD.metata.labels will be removed after upgrade to v0.52.0.
Update note 2: VMAuth.spec.unauthorizedAccessConfig is deprecated in favour of VMAuth.spec.unauthorizedUserAccessSpec. Operator still serves deprecated fields until v1.0 release.
Update note 3: The following fields: [default_url,tlsConfig,discover_backend_ips,headers,response_headers,retry_status_codes,max_concurrent_requests,load_balancing_policy,drop_src_path_prefix_parts] are deprecated at VMAuth.spec. in favour of VMAuth.spec.unauthorizedUserAccessSpec. Operator still serves deprecated fields until v1.0 release.
"app.kubernetes.io/part-of": "vmcluster" label to the objects generated for VMCluster components. It helps to use labels selectors to identify objects belong to the cluster.spec setting unauthorizedUserAccessSpec that replaces unauthorizedAccessConfig and inlined fields from VMUserConfigOptions. See this issue for details.annotations to the PodDisruptionBudget and HorizontalPodAutoscaler objects generated.vmagentSpec.ScrapeConfigSelector and vmagentSpec.scrapeConfigNamespaceSelector when vmagentSpec.selectAllByDefault=false. Previously, the VMScrapeConfig could be ignored.xxxNamespaceSelector when vmagentSpec.selectAllByDefault=true. See this doc for detailed rules.license.forceOffile and license.reloadInterval options. See this doc for the details.securityContext to the containers with useStrictSecurity: false. See this issue for details.containers with enabled useStrictSecurity: true. It sets privileged: false.msg body, change logger field to properly display controller.CRD name. See this issue for details.managedMetadata to VMCluster.spec, VMAgent.spec,VMAlert.spec, VMAuth.spec,VMAlertmanager.Spec, VMSingle.spec andVLogs.spec. It controls labels and annotations added to the objects created operator (such as Deployment). See this issue for details.replace directive from go.mod.status sub-resource for VMUser, VMAlertmanager, VMRule and VMScrape.* objects. Add new conditions field, that represents resources conditions. See this issue for details.Nothing published for this version
Nothing published for this version
vmoperator: add missing container labels to the metrics discovered with VMServiceScrape for endpointslices discovery role.
container labels to the metrics discovered with VMServiceScrape for endpointslices discovery role.VM_VMSERVICESCRAPEDEFAULT_ENFORCEENDPOINTSLICES to use endpointslices instead of endpoints as discovery role for VMServiceScrape when generate scrape config for VMAgent.loggerJSONFields to the operator logger configuration. It allows to change json encoder fields. See this issue for details.observedGeneration. See this issue for details.updateStatus field for CRD objects. It replaces status, clusterStatus and singleStatus for VLogs, VMCluster and VMSingle with generic updateStatus.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
vmrule: properly validate rules for vlogs group type.
type.VMScrapeConfig during operator start-up.operational update status for CRDs. Previously, operational status could be set before rollout finishes at Kubernetes due to bug at Kubernetes controller-manager.Full Changelog: https://github.com/VictoriaMetrics/operator/compare/v0.49.0...v0.49.1
Nothing published for this version
operator: properly apply useStrictSecurity: true to the initContainers for VMAuth, VMAgent and VMAlertmanager. See this issue for details.
useStrictSecurity: true to the initContainers for VMAuth, VMAgent and VMAlertmanager. See this issue for details.spec.configSecret to spec.externalConfig.secretRef.name and added spec.externalConfig.localPath to be able to provide custom configs via sidecar.requestsLoadBalancer configuration to the VMCluster.spec. See this issue for details.VMCluster with enabled backup.ConfigMap provided via .spec.configMap are changed.Nothing published for this version
api: adds new fields maxDiskUsagePerUrl andforceVMProto to the VMagent remoteWriteSpec
maxDiskUsagePerUrl andforceVMProto to the VMagent remoteWriteSpecstatefulMode. See this issue for details.OwnerRefrence for Role and RoleBinding at single-namespace operator mode.useStrictSecurity enabled by removing default values for AppArmorProfile and SeccompProfile. See this issue for details.Full Changelog: https://github.com/VictoriaMetrics/operator/compare/v0.48.3...v0.48.4
Nothing published for this version
Nothing published for this version
vmcluster: properly apply global container registry from configuration. It was ignored for VMCluster since v0.48.0 release. See this issue for details
VMCluster since v0.48.0 release. See this issue for details.--disableControllerForCRD. It allows to disable reconcile controller for the given comma-separated list of CRD names. See this issue for details.Nothing published for this version
Nothing published for this version
operator: properly expose vm_app_version metric tag with version and short_version build info. It was broken since v0.46.0 release.
vm_app_version metric tag with version and short_version build info. It was broken since v0.46.0 release.controller.maxConcurrentReconciles from 1 to 5. It should improve reconcile performance for the most installations.rest_client_request_duration_seconds, sched_latencies_seconds. It allows to better debug operator reconcile latencies.Nothing published for this version
Nothing published for this version
vmalertmanager: properly build service, previously port by number instead of name was used. It produced updating service log messages.
updating service log messages.imagePullSecrets to the components. Due to bug at 0.48.0 operator ignored vmcluster.spec.imagePullSecrets See this issue for details.Nothing published for this version
api: adds new fields useVMConfigReloader, configReloaderImageTag, configReloaderResources to the VMagent, VMAlert, VMAuth, and VMAlertmanager.
useVMConfigReloader, configReloaderImageTag, configReloaderResources to the VMagent, VMAlert, VMAuth, and VMAlertmanager.enforcedTopRouteMatchers. It adds given alert label matchers to the top route of any VMAlertmanagerConfig. See this issue for details.host_aliases setting, which has priority over hostAliases.useDefaultResources setting to the all applications. It has priority over global operator setting.clusterDomainName to the VMCluster and VMAlertmanager. It defines optional suffix for in-cluster addresses.disableSelfServiceScrape setting to the all applications. It has priority over global operator setting.securityContext and apply security configuration parameters to the containers.VM_DEFAULTLABELS, VM_PODWAITREADYINITDELAY. Adds new variable VM_APPREADYTIMEOUT.hostAliases fields to spec. See this issue for details.secrets and configmaps. Adds new flag -controller.disableCacheFor=seccret,configmap to disable it if needed.Secret and Configmap values by default. This behaviour could be changed with flag disableSecretKeySpaceTrim. Related issue.Full Changelog: https://github.com/VictoriaMetrics/operator/compare/v0.47.3...v0.48.0
Nothing published for this version
api: adds new fields useVMConfigReloader, configReloaderImageTag, configReloaderResources to to the VMagent, VMAlert, VMAuth, and VMAlertmanager.
useVMConfigReloader, configReloaderImageTag, configReloaderResources to to the VMagent, VMAlert, VMAuth, and VMAlertmanager.enforcedTopRouteMatchers. It adds given alert label matchers to the top route of any VMAlertmanagerConfig. See this issue for details.host_aliases setting, which has priority over hostAliases.useDefaultResources setting to the all applications. It has priority over global operator setting.clusterDomainName to the VMCluster and VMAlertmanager. It defines optional suffix for in-cluster addresses.disableSelfServiceScrape setting to the all applications. It has priority over global operator setting.securityContext and apply security configuration parameters to the containers.VM_DEFAULTLABELS, VM_PODWAITREADYINITDELAY. Adds new variable VM_APPREADYTIMEOUT.hostAliases fields to spec. See this issue for details.secrets and configmaps. Adds new flag -controller.disableCacheFor=seccret,configmap to disable it if needed.Secret and Configmap values by default. This behaviour could be changed with flag disableSecretKeySpaceTrim. Related issue.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
operator: fixes statefulset reconcile endless loop for kubernetes versions < 1.27. Bug introduced at v0.47.0 version with commit.
vmalertmanager: allow to change webserver listen port with spec.Port. See this PR for details.
spec.Port. See this PR for details.rollingUpdate strategyType readiness check.crd.kind enum param for VMAlertmanager, it now supports both VMAlertmanager and VMAlertManager. See this issue for details.configReloaderExtraArgs.Nothing published for this version
Nothing published for this version
It is recommended upgrading to [operator v0.47.2](https://docs.victoriametrics.com/operator/changelog/#v0472---26-aug-2024) because v0.47.1 contains a
It is recommended upgrading to operator v0.47.2 because v0.47.1 contains a bug, which can lead to endless statefulset reconcile loop.
revisionHistoryLimitCount change. See this issue for details.tls_config for emails notifications. See this issue for details.reload prefix to all config-reloader tls* flags to avoid collision with flags from external package. See this issueOne column per quarter.