dartfx/n8n-runners repository overview

⁠dartfx/n8n-runners

Unified multi-language external Task Runner sidecar for n8n⁠, built on dartfx/base⁠ with Debian, Python 3.14, Data Artifex toolkits, Node.js LTS, and QSV⁠.

⁠Highlights

• Unified Multi-Language Execution: Executes both Python and JavaScript Code nodes in isolated runner worker processes managed by n8n's native task-runner-launcher.
• Built on dartfx/base: Uses modern Debian Linux, Python 3.14, and glibc, providing rock-solid stability for native C-extensions and numerical libraries.
• Pre-Loaded Python Toolkit:
  • Data Artifex Ecosystem: dartfx-utils, dartfx-qsv, dartfx-ckan, dartfx-dataverse, dartfx-ddi, dartfx-nada, dartfx-rdf, and dartfx-unf.
  • Data Engineering & Scraping: pandas, openpyxl, psycopg[binary], requests, httpx, curl_cffi, beautifulsoup4, and pypdf.
• Integrated QSV Binary: Includes the static qsv CLI executable for ultra-fast CSV processing and SQL querying.
• Modern Node.js Stack: Bundles Node.js LTS (20.x) with pnpm, nvm, and popular execution libraries (axios, lodash).
• Hardened Security: Runs with non-privileged user appuser (UID 10001) under tini init supervision.

⁠Docker Compose Setup

Pair dartfx/n8n-runners directly with dartfx/n8n⁠:

services:
  n8n:
    image: dartfx/n8n:next
    ports:
      - "5678:5678"
    environment:
      - N8N_RUNNERS_MODE=external
      - N8N_RUNNERS_BROKER_LISTEN_ADDRESS=0.0.0.0
      - N8N_RUNNERS_AUTH_TOKEN=replace_with_a_secure_runner_auth_token_32chars
    volumes:
      - n8n_data:/home/node/.n8n
      - shared_data:/data/shared

  n8n-runners:
    image: dartfx/n8n-runners:next
    restart: unless-stopped
    environment:
      - N8N_RUNNERS_MODE=external
      - N8N_RUNNERS_AUTH_TOKEN=replace_with_a_secure_runner_auth_token_32chars
      - N8N_RUNNERS_TASK_BROKER_URI=http://n8n:5679
    volumes:
      - shared_data:/data/shared
    depends_on:
      - n8n

volumes:
  n8n_data:
  shared_data:

⁠Available Tags

• latest, 2.46.3 - Stable runner builds aligned with upstream n8n releases.
• next - Next-generation runner builds matching n8n v3.
• staging, next-staging, 2.46.3-staging - Pre-release validation builds.

⁠Support & Links

• Source Code: https://github.com/DataArtifex/docker-n8n⁠
• Main n8n Image: https://hub.docker.com/r/dartfx/n8n⁠
• Base Foundation Image: https://hub.docker.com/r/dartfx/base⁠
• Support: Data Artifex <[email protected]⁠>