How to configure native Python Runner in sidecar mode for n8n v2?

Questions
1

Describe the problem/error/question

What is the error message (if any)?

Please share your workflow

Share the output returned by the last node

Information on your n8n setup

  • n8n version:
  • Database (default: SQLite):
  • n8n EXECUTIONS_PROCESS setting (default: own, main):
  • Running n8n via (Docker, npm, n8n cloud, desktop app):
  • Operating system:
2

Based on the search results, here’s how to configure the native Python runner in sidecar mode for n8n v2:

You’ll need to set up the `n8nio/runners` image as a sidecar container alongside your n8n instance. In your docker-compose configuration, add the task runner service and configure n8n with these environment variables: `N8N_RUNNERS_ENABLED=true`, `N8N_RUNNERS_MODE=external`, `N8N_RUNNERS_BROKER_LISTEN_ADDRESS=0.0.0.0`, `N8N_RUNNERS_AUTH_TOKEN=your-secret-token`, and `N8N_NATIVE_PYTHON_RUNNER=true`.

Make sure the `n8nio/runners` image version matches your `n8nio/n8n` image version (both must be >=1.111.0). You can find a complete docker-compose example in the [n8n docs]( Task runners | n8n Docs ) that shows the exact configuration needed for external mode with Python support.

If you’re using queue mode, remember that each worker needs its own sidecar container for task runners.