Development

To set up a development environment, follow these steps:

Install Go >=1.23, golangci-lint and make.
Clone this repository and create a config file.

git clone https://github.com/n8n-io/task-runner-launcher
cd task-runner-launcher
touch config.json && echo '<json-config-content>' > config.json
sudo mv config.json /etc/n8n-task-runners.json

Make your changes.
Build launcher:

make build

Start n8n >= 1.69.0:

export N8N_RUNNERS_ENABLED=true
export N8N_RUNNERS_MODE=external
export N8N_RUNNERS_AUTH_TOKEN=...     # random string
pnpm start

Start launcher:

export N8N_RUNNERS_AUTH_TOKEN=...     # same string as in step 5
make run

Tip

You can use N8N_RUNNERS_LAUNCHER_LOG_LEVEL=debug for granular logging and NO_COLOR=1 to disable color output.