How can I set up a working docker-compose.yml for N8N queue mode scaling?

Below is an example docker-compose file that you can use as a starting point to run n8n in queue mode. This file sets the environment variable EXECUTIONS_MODE to queue so that n8n schedules executions accordingly. Feel free to modify it to match your requirements (for example, by adding a proper database or adjusting other environment settings):

YAMLCopied
version: "3.7"

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    environment:
      # Enable queue mode for executing workflows
      - EXECUTIONS_MODE=queue

      # Optional: adjust worker settings as needed – for example, the maximum jobs to process simultaneously:
      - QUEUE_MODE_MAX_JOB_PROCESS=10

      # Other common n8n settings (adjust as needed)
      - N8N_HOST=localhost
      - N8N_PORT=5678

      # Optional: basic authentication to secure your instance
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=yourUser
      - N8N_BASIC_AUTH_PASSWORD=yourPassword

    volumes:
      # Persist n8n data including workflows and credentials
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

Notes

• Persistence: This example uses a Docker volume (n8n_data) to persist your workflows and credentials, which is important for retaining your data between container restarts.
• Database Considerations: By default, n8n uses SQLite. For production or high-scale queue setups, you might want to connect to an external database (like Postgres) and adjust the environment variables accordingly.
• Further Configuration: The queue mode comes with additional configuration variables (such as a specific timeout setting or retries) if you need finer control over job processing. See the Queue Mode documentation for more details.

This docker-compose setup should help you get started quickly with a proven configuration for queue mode. Adjust and extend the configuration as needed for your environment.