Upgrade component version v0 to v1

Version 1.x is a major overhaul of the configuration parameters of the component, see Release Notes for more details.

The component has lots of options to configure each part of the Loki installation. Please have a look at the parameters documentation for reference.

As of March 16, 2026, the Grafana Loki Helm chart for OSS users has moved to grafana-community/helm-charts (forked at chart version 6.55.0). This component will no longer support Helm charts from grafana/loki, instead it uses Helm charts from grafana-community (> v17.x).

Explanation of configuration changes

Migrate to Deployment Mode Distributed

Prior version of this component used the deployment mode SimpleScalable, see Loki Documentation. This mode is deprecated and will be removed with Loki v4. Only the preset legacy will support SimpleScalable, but it is strongly adviced to switch away from SimpleScalable and legacy.

Step 1

Deploy v1.x of this component with the following parameters:

preset: legacy (1)
helm_values:
  deploymentMode: SimpleScalable<->Distributed (2)
1 Uses legacy preset for component configuration.
2 Prepares for the transition to Distributed.

Step 2

Remove the parameters from "Step 1" and deploy again.

New Namespace Naming

This component will change the default name of the namespace to the instance name. It is also no longer allowed to configure an non-instantiated version.

If you have configured a namespace name that is different than the instance name, then change the namespace name here:

namespace:
  name: ${_instance} (1)
1 Overwrite the default namespace name.

If you have configured the component in a non-instantiated version, then change the following:

applications:
  - loki as your-new-instance-name (1)

parameters:
  your_new_instance_name: (2)
    namespace:
      name: ${_instance} (3)
1 Redefine the component include in applications.
2 Rename the component configuration as your new instance name.
3 Overwrite the default namespace name.

(Optional) Consider disabling Zone Aware Replication

This version of the component disables zone aware replication by default, because the rollout-operator in this version of the component installs CRDs for certain functionalities.

That can be a problem, when more than 1 instance of this component is installed. We recommend disabling zone aware replication, unless you need this feature and have a cluster that actually has multiple availability zones enabled.

See global configuration for reference.

New Default Resource Requests

This component changes its default resource requests and limits, please check the output of your catalog compilation and adjust if needed. See components and caches to adjust your settings.

This component supports the following presets:

  • none: Use the Helm charts defaults.

  • legacy: Component defaults for migrating to v1.

  • extra-small: Component defaults for small production deployments (default).

legacy globalNodeSelector

The values for the global node selector has moved to global.nodeSelector.

This change is backward compatible, but migrating the values to the new structure is recommended.