From 1944c522258e412c8f95309036b0550a05248c4a Mon Sep 17 00:00:00 2001 From: Manuel Buil Date: Thu, 23 Jul 2026 11:22:16 +0200 Subject: [PATCH] Add docs about the new helm-controller flag Signed-off-by: Manuel Buil --- docs/add-ons/helm.md | 18 ++++++++++++++++++ docs/cli/server.md | 2 +- 2 files changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/add-ons/helm.md b/docs/add-ons/helm.md index 4a2dc30c4e..f6c68a1852 100644 --- a/docs/add-ons/helm.md +++ b/docs/add-ons/helm.md @@ -12,6 +12,24 @@ K3s includes a [Helm Controller](https://github.com/k3s-io/helm-controller/) tha The [HelmChart Custom Resource](https://github.com/k3s-io/helm-controller#helm-controller) captures most of the options you would normally pass to the `helm` command-line tool. +K3s also supports passing arguments directly to the `helm-controller` process with `helm-controller-arg`. +This is useful when you want to tune controller behavior globally. + +For example, to customize the CPU and memory resources allocated to Helm job pods: + +```yaml +# /etc/rancher/k3s/config.yaml +helm-controller-arg: + - 'job-resources={"requests": {"cpu": "0.2", "memory": "64M"}, "limits": {"cpu": "1", "memory": "256M"}}' +``` + +You can specify `helm-controller-arg` multiple times in CLI form, or as a YAML list in the configuration file. + +:::info Version Gate +The `helm-controller-arg` flag is available since the K3s July 2026 releases: v1.36.3+k3s1, v1.35.7+k3s1, v1.34.10+k3s1, v1.33.13+k3s2 +::: + + ### HelmChart Field Definitions :::note diff --git a/docs/cli/server.md b/docs/cli/server.md index ea61b514b1..0db8c1a679 100644 --- a/docs/cli/server.md +++ b/docs/cli/server.md @@ -234,7 +234,7 @@ OPTIONS: --write-kubeconfig value, -o value (client) Write kubeconfig for admin client to this file [$K3S_KUBECONFIG_OUTPUT] --write-kubeconfig-mode value (client) Write kubeconfig with this mode [$K3S_KUBECONFIG_MODE] --write-kubeconfig-group value (client) Write kubeconfig with this group [$K3S_KUBECONFIG_GROUP] - --helm-job-image value (helm) Default image to use for helm jobs + --helm-controller-arg value (helm) Customized configuration for helm-controller process --token value, -t value (cluster) Shared secret used to join a server or agent to a cluster [$K3S_TOKEN] --token-file value (cluster) File containing the token [$K3S_TOKEN_FILE] --agent-token value (cluster) Shared secret used to join agents to the cluster, but not servers [$K3S_AGENT_TOKEN]