n8n

Architecture:

• Queue mode (multiple workers)
• PostreSQL
• Redis
• Prepared to be behind Traefik as reverse proxy

Here you can find 2 options:

• Local development environment with docker-compose-devel.yaml
• Server deployment behind Traefik with docker-compose-srv.yaml. It requires an external Traefik with Docker provider configured.

Setup

1. Choose your environment

Make a symlink with the correct docker-compose file:

• Local: ln -s docker-compose-devel.yaml docker-compose.yaml
• Server: ln -s docker-compose-srv.yaml docker-compose.yaml

2. Prepare the environment

Prepare the .env files:

• .env. Use .env.example as base.
• db/.env. Use db/.env.example as base.
• n8n/.env. Use n8n/.env.example as base.

All the .env files follow this rules:

• Divided by sections
• The required ENV values, that must be manually checked/filled, are uncommented. The rest that are commented are optional.
• All the ENV variables that have a default value, are assigned with that value.
• If the type of the value is an Enum, it has a comment below with the possible values.

3. UI configuration

You can add extra features registering the Community Edition with a License Key.

Roadmap

• Multiple server configurations (more than one docker-compose-srv.yaml). Add one simpler without queue. Possible options: -basic and -queue
• Add a server configuration with separated webhook containers (also replicable, -queue-webhook).

References

• Official n8n GitHub Repo: n8n with PostgreSQL and Worker
• Official nn Docs: Self-hosting n8n
• Official n8n Docs: Docker Installation
• Official n8n Docs: Server setups > Docker-Compose
• Official n8n Docs: Community Edition features