dartfx/n8n repository overview

⁠dartfx/n8n

Official Data Artifex distribution of n8n⁠ packaged with the blazing-fast QSV⁠ tabular data-wrangling toolkit and pre-installed @dartfx/n8n-nodes-qsv⁠ community nodes.

⁠Highlights

• Official n8n Core: Extends upstream n8nio/n8n (supports both v3 via next and v2 via latest).
• Integrated QSV Toolkit: Bundles the full static Linux binary of qsv at /usr/local/bin/qsv with 75+ subcommands for ultra-fast CSV/TSV slicing, statistics, SQL querying (sqlp), regex transformations, format conversions (to), and validation.
• Pre-installed Community Node: Includes @dartfx/n8n-nodes-qsv in /opt/n8n-custom-nodes, eliminating the need to install it manually on every container launch and avoiding volume mount collision.
• External Task Runner Ready: Configured to seamlessly connect to dartfx/n8n-runners⁠ for isolated, multi-language execution (Python 3.14 & Node.js).
• Multi-Architecture: Native builds for both linux/amd64 and linux/arm64.

⁠Quick Start

⁠Standalone (Development / Evaluation)

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e N8N_COMMUNITY_PACKAGES_ENABLED=true \
  -v n8n_data:/home/node/.n8n \
  dartfx/n8n:next

Once running, access n8n at http://localhost:5678.

⁠Production Deployment (Recommended)

In production environments, pair dartfx/n8n with the dartfx/n8n-runners sidecar and PostgreSQL 18:

services:
  n8n:
    image: dartfx/n8n:next
    container_name: n8n-main
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=localhost
      - N8N_PROTOCOL=http
      - WEBHOOK_URL=http://localhost:5678/
      - N8N_ENCRYPTION_KEY=replace_with_a_secure_encryption_key_32chars
      # External Task Runners
      - 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
      # Community Nodes & Custom Extensions
      - NODES_EXCLUDE=[]
      - N8N_COMMUNITY_PACKAGES_ENABLED=true
      - N8N_CUSTOM_EXTENSIONS=/opt/n8n-custom-nodes
    volumes:
      - n8n_data:/home/node/.n8n
      - shared_data:/data/shared

  n8n-runners:
    image: dartfx/n8n-runners:next
    container_name: n8n-task-runner
    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:

⁠Key Environment Variables

⁠Available Tags

• latest, 2.46.3 - Stable n8n release builds.
• next - Next-generation n8n v3 builds.
• staging, next-staging, 2.46.3-staging - Pre-release validation builds.

⁠Support & Links

• Source Code: https://github.com/DataArtifex/docker-n8n⁠
• QSV Node Source: https://github.com/DataArtifex/dartfx-n8n-nodes-qsv⁠
• Issues & Feedback: GitHub Issues⁠
• Support: Data Artifex <[email protected]⁠>