Task runner environment variables#

File-based configuration

You can add _FILE to individual variables to provide their configuration in a separate file. Refer to Keeping sensitive data in separate files for more details.

Task runners execute code defined by the Code node.

n8n instance environment variables#

Variable	Type	Default	Description
`N8N_RUNNERS_ENABLED`	Boolean	`false`	Are task runners enabled.
`N8N_RUNNERS_MODE`	Enum string: `internal`, `external`	`internal`	How to launch and run the task runner. `internal` means n8n will launch a task runner as child process. `external` means an external orchestrator will launch the task runner.
`N8N_RUNNERS_AUTH_TOKEN`	String	Random string	Shared secret used by a task runner to authenticate to n8n. Required when using `external` mode.
`N8N_RUNNERS_BROKER_PORT`	Number	`5679`	Port the task broker listens on for task runner connections.
`N8N_RUNNERS_BROKER_LISTEN_ADDRESS`	String	`127.0.0.1`	Address the task broker listens on.
`N8N_RUNNERS_MAX_PAYLOAD`	Number	`1 073 741 824`	Maximum payload size in bytes for communication between a task broker and a task runner.
`N8N_RUNNERS_MAX_OLD_SPACE_SIZE`	String		The `--max-old-space-size` option to use for a task runner (in MB). By default, Node.js will set this based on available memory.
`N8N_RUNNERS_MAX_CONCURRENCY`	Number	`5`	The number of concurrent tasks a task runner can execute at a time.
`N8N_RUNNERS_TASK_TIMEOUT`	Number	`60`	How long (in seconds) a task can take to complete before the task aborts and the runner restarts. Must be greater than 0.
`N8N_RUNNERS_HEARTBEAT_INTERVAL`	Number	`30`	How often (in seconds) the runner must send a heartbeat to the broker, else the task aborts and the runner restarts. Must be greater than 0.
`N8N_RUNNERS_INSECURE_MODE`	Boolean	`false`	Whether to disable all security measures in the task runner, for compatibility with modules that rely on insecure JS features. Discouraged for production use.

Task runner launcher environment variables#

Variable	Type	Default	Description
`N8N_RUNNERS_LAUNCHER_LOG_LEVEL`	Enum string: `debug`, `info`, `warn`, `error`	`info`	Which log messages to show.
`N8N_RUNNERS_AUTH_TOKEN`	String	-	Shared secret used to authenticate to n8n.
`N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT`	Number	`15`	The number of seconds to wait before shutting down an idle runner.
`N8N_RUNNERS_TASK_BROKER_URI`	String	`http://127.0.0.1:5679`	The URI of the task broker server (n8n instance).
`N8N_RUNNERS_LAUNCHER_HEALTH_CHECK_PORT`	Number	`5680`	Port for the launcher's health check server.
`N8N_RUNNERS_MAX_PAYLOAD`	Number	`1 073 741 824`	Maximum payload size in bytes for communication between a task broker and a task runner.
`N8N_RUNNERS_MAX_CONCURRENCY`	Number	`5`	The number of concurrent tasks a task runner can execute at a time.

Task runner environment variables (all languages)#

Variable	Type	Default	Description
`N8N_RUNNERS_GRANT_TOKEN`	String	Random string	Token the runner uses to authenticate with the task broker. This is automatically provided by the launcher.
`N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT`	Number	`15`	The number of seconds to wait before shutting down an idle runner.
`N8N_RUNNERS_TASK_BROKER_URI`	String	`http://127.0.0.1:5679`	The URI of the task broker server (n8n instance).
`N8N_RUNNERS_LAUNCHER_HEALTH_CHECK_PORT`	Number	`5680`	Port for the launcher's health check server.
`N8N_RUNNERS_MAX_PAYLOAD`	Number	`1 073 741 824`	Maximum payload size in bytes for communication between a task broker and a task runner.
`N8N_RUNNERS_MAX_CONCURRENCY`	Number	`5`	The number of concurrent tasks a task runner can execute at a time.

Task runner environment variables (JavaScript)#

Variable	Type	Default	Description
`NODE_FUNCTION_ALLOW_BUILTIN`	String	-	Permit users to import specific built-in modules in the Code node. Use * to allow all. n8n disables importing modules by default.
`NODE_FUNCTION_ALLOW_EXTERNAL`	String	-	Permit users to import specific external modules (from `n8n/node_modules`) in the Code node. n8n disables importing modules by default.
`N8N_RUNNERS_ALLOW_PROTOTYPE_MUTATION`	Boolean	`false`	Whether to allow prototype mutation for external libraries. Set to `true` to allow modules that rely on runtime prototype mutation (for example, `puppeteer`) at the cost of relaxing security.
`GENERIC_TIMEZONE`	*	`America/New_York`	The same default timezone as configured for the n8n instance.
`NODE_OPTIONS`	String	-	Options for Node.js.
`N8N_RUNNERS_MAX_OLD_SPACE_SIZE`	String		The `--max-old-space-size` option to use for a task runner (in MB). By default, Node.js will set this based on available memory.

Task runner environment variables (Python)#

Variable	Type	Default	Description

| N8N_RUNNERS_STDLIB_ALLOW | String | - | Permit users to import specific Python standard library modules in the Code node. Use * to allow all. n8n disables all Python standard library imports by default. | | N8N_RUNNERS_EXTERNAL_ALLOW | String | - | Permit users to import specific third-party Python modules (if available in the n8nio/runners image) in the Code node. Use * to allow all. n8n disables all third-party Python modules by default. | | N8N_RUNNERS_BUILTINS_DENY | String | eval,exec,compile,open,input,breakpoint,getattr,object,type,vars,setattr,delattr,hasattr,dir,memoryview,__build_class__ | List of insecure Python built-ins aren't allowed. Set to an empty string to allow all. |

This page was