Do not supply CMD or ARGS for v2 runners.

Signed-off-by: Josh Baird <jbaird@galileo.io>

Author: joshuabaird

README.md

@@ -836,11 +836,15 @@ worker:
   image:
     repository: n8nio/runners
     tag: "2.0.0"
+  # IMPORTANT: Do NOT set command or commandArgs when using n8nio/runners
+  # The runners image has its own launcher and doesn't use "n8n worker" commands
 ```
 
 **Key points:**
 - The main n8n application continues to use `n8nio/n8n`
 - Workers/task runners must use `n8nio/runners` for n8n v2.0+
+- **Do not set `worker.command` or `worker.commandArgs`** when using the runners image - it has its own entrypoint/launcher
+- The chart automatically omits command/args when a custom worker image is specified
 - If `worker.image.*` is not specified, it defaults to the global `image.*` configuration (backwards compatible)
 - You can specify different tags for main and worker if needed
 

charts/n8n/templates/deployment.worker.yaml

@@ -82,15 +82,21 @@ spec:
               {{- toYaml $value | nindent 14 }}
             {{- end }}
           {{- if .Values.worker.command }}
+          {{- /* User has specified a custom command, use it */ -}}
           command:
             {{- toYaml .Values.worker.command | nindent 12 }}
+          {{- else if .Values.worker.image.repository }}
+          {{- /* Worker is using a custom image (likely n8nio/runners for v2) - don't set command, let image entrypoint run */ -}}
           {{- else }}
+          {{- /* Default to n8n v1 worker command */ -}}
           command: ["n8n"]
           {{- end }}
           {{- if .Values.worker.commandArgs }}
+          {{- /* User has specified custom args, use them */ -}}
           args:
             {{- toYaml .Values.worker.commandArgs | nindent 12 }}
-          {{- else }}
+          {{- else if not .Values.worker.image.repository }}
+          {{- /* Only set default args if using the main n8n image (v1 behavior) */ -}}
           args:
             - "worker"
             - "--concurrency={{ .Values.worker.concurrency }}"

charts/n8n/values.yaml

@@ -283,6 +283,10 @@ worker:
   # For n8n v2.0+, you should use the separate task runner image: n8nio/runners
   # For n8n v1.x, leave these empty to use the main n8n image.
   # See: https://docs.n8n.io/2-0-breaking-changes/#remove-task-runner-from-n8nion8n-docker-image
+  #
+  # IMPORTANT: When using n8nio/runners image, do NOT set command/commandArgs below.
+  # The runners image has its own launcher and doesn't use the "n8n worker" command.
+  # The chart will automatically omit command/args when a custom image is specified.
   image:
     # For n8n v2+, set to n8nio/runners
     # If empty, defaults to .Values.image.repository (n8nio/n8n)
@@ -395,19 +399,15 @@ worker:
   #      command: ["/bin/sh", "-c", "apk add mysql-client"]
 
   # here you can override a command for worker container
-  # it may be used to override a starting script (e.g., to resolve issues like https://github.com/n8n-io/n8n/issues/6412) or
-  # run additional preparation steps (e.g., installing additional software)
+  # IMPORTANT: When using n8nio/runners (n8n v2), do NOT set this. The runners image
+  # has its own launcher. Only set this for custom configurations.
+  # For n8n v1 workers, the default is ["n8n"] which is set automatically.
   command: []
 
-  # sample configuration that overrides starting script and solves above issue (also it runs n8n as root, so be careful):
-  # command:
-  #  - tini
-  #  - --
-  #  - /bin/sh
-  #  - -c
-  #  - chmod o+rx /root; chown -R node /root/.n8n || true; chown -R node /root/.n8n; ln -s /root/.n8n /home/node; chown -R node /home/node || true; node /usr/local/bin/n8n
-
   # command args
+  # IMPORTANT: When using n8nio/runners (n8n v2), do NOT set this. The runners image
+  # manages its own process. Only set this for custom configurations.
+  # For n8n v1 workers, the default is ["worker", "--concurrency=X"] which is set automatically.
   commandArgs: []
 
   # here you can override the livenessProbe for the main container

examples/values_full.yaml

@@ -73,6 +73,8 @@ worker:
   # image:
   #   repository: n8nio/runners
   #   tag: 2.0.0
+  # IMPORTANT: Do NOT set command or commandArgs when using n8nio/runners
+  # The runners image has its own launcher and doesn't accept "n8n worker" commands
   # See: https://docs.n8n.io/2-0-breaking-changes/#remove-task-runner-from-n8nion8n-docker-image
   extraEnv: *extraEnv # using YAML magic (anchors) to reference main extraEnv
   extraVolumeMounts: *extraVolumeMounts # using YAML magic (anchors) to reference main extraVolumeMounts