You can change n8n's settings using environment variables. For a full list of available configurations see Environment Variables.
Set environment variables by command line#
For npm, set your desired environment variables in terminal using the
export command as shown below:
In Docker you can use the
-e flag from the command line:
1 2 3 4 5
Set environment variables using a file#
You can also configure n8n using a configuration file.
Only define the values that need to be different from the default in your configuration file. You can use multiple files. For example, you can have a file with generic base settings, and files with specific values for different environments.
Set the path to the JSON configuration file using the environment variable
1 2 3 4 5 6 7 8
1 2 3 4 5 6 7 8 9 10 11 12
Formatting as JSON
You can't always work out the correct JSON from the Environment variables reference. For example, to set
true, you need to do:
1 2 3 4 5 6 7
Refer to the Schema file in the source code for full details of the expected settings.
In Docker, you can set your environment variables in the
n8n: environment: element of your
1 2 3
Keeping sensitive data in separate files#
You can append
_FILE to some individual environment variables to provide their configuration in a separate file, enabling you to avoid passing sensitive details using environment variables. n8n loads the data from the file with the given name, making it possible to load data from Docker- and Kubernetes-Secrets.
The following environment variables support file input:
Requires manual UI build
This variable requires a manual build of the
n8n-editor-ui package. You can't use it with the default n8n Docker image. The default is
/, meaning that it uses the root-domain.
Tells the front end how to reach the REST API of the back end:
n8n creates a random encryption key automatically on the first launch and saves
it in the
~/.n8n folder. n8n uses that key to encrypt the credentials before
they get saved to the database. It's possible to overwrite the key and
set it using an environment variable.
Execute all workflows in the same process#
own mode and the
EXECUTIONS_PROCESS flag in version 1.0. They will be removed in a future release. Main mode is now the default, so this step isn't needed for version 1.0 and above.
Use Queue mode if you need full execution isolation.
All workflows run in their own separate process. This ensures that all CPU cores get used and that they don't block each other on CPU intensive tasks. It also makes sure that one execution crashing doesn't take down the whole application. The disadvantage is that it slows down the start-time considerably and uses much more memory. If your workflows aren't CPU intensive, and they have to start very fast, it's possible to run them all directly in the main-process with this setting.
A workflow times out and gets canceled after this time (in seconds). If the workflow runs in the main process, a soft timeout happens (takes effect after the current node finishes). If a workflow runs in its own process, n8n attempts a soft timeout first, then kills the process after waiting for an additional fifth of the given timeout duration.
EXECUTIONS_TIMEOUT default is
-1. For example, if you want to set the timeout to one hour:
You can also set maximum execution time (in seconds) for each workflow individually. For example, if you want to set maximum execution time to two hours:
Custom nodes location#
Every user can add custom nodes that get loaded by n8n on startup. The default
location is in the subfolder
.n8n/custom of the user who started n8n.
You can define additional folders with an environment variable:
Use built-in and external modules in the Code node#
For security reasons, the Code node restricts importing modules. It's possible to lift that restriction for built-in and external modules by setting the following environment variables:
NODE_FUNCTION_ALLOW_BUILTIN: For built-in modules
NODE_FUNCTION_ALLOW_EXTERNAL: For external modules sourced from n8n/node_modules directory. External module support is disabled when an environment variable isn't set.
1 2 3 4 5 6 7 8 9 10 11
The default timezone is "America/New_York". For instance, the Schedule node uses it to know at what time the workflow should start. To set a different default timezone, set
GENERIC_TIMEZONE to the appropriate value. For example, if you want to set the timezone to Berlin (Germany):
You can find the name of your timezone here.
n8n saves user-specific data like the encryption key, SQLite database file, and
the ID of the tunnel (if used) in the subfolder
.n8n of the user who started n8n. It's possible to overwrite the user-folder using an environment variable.
n8n creates the webhook URL by combining
N8N_PORT. If n8n runs behind a reverse proxy, that won't work. That's because n8n runs internally on port 5678 but is exposed to the web using the reverse proxy on port 443. In that case, it's important to set the webhook URL manually so that n8n can display it correctly in the Editor UI and register the correct webhook URLs with external services.
Prometheus metrics are an experimental feature.
To collect and expose metrics, n8n uses the prom-client library.
/metrics endpoint is disabled by default, but it's possible to enable it using the
N8N_METRICS environment variable.
Refer to the respective Environment Variables (
N8N_METRICS_INCLUDE_*) for configuring which metrics and labels should get exposed.