Docker Self-Hosting, Variabile de Mediu & Queue Mode în n8n & Automatizări AI

Configurația recomandată de Docker Compose pentru găzduirea n8n pe propriul server (VPS sau local), conectarea la PostgreSQL, Ollama local și scalarea cu Redis.

Configurare nod & expresie
services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    ports: ["5678:5678"]
    environment:
      - N8N_ENCRYPTION_KEY=cheie_secreta_32_caractere
      - WEBHOOK_URL=https://n8n.domeniultau.ro/
      - GENERIC_TIMEZONE=Europe/Bucharest
    volumes:
      - n8n_data:/home/node/.n8n

Descriere & Utilizare

Unul dintre cele mai mari avantaje ale platformei n8n față de Zapier sau Make este că o poți găzdui gratuit pe propriul server Linux (self-hosted) prin Docker, fără limite artificiale pe numărul de pași executați și păstrând toate datele clienților pe infrastructura ta.

Pentru un mediu de producție stabil, se recomandă înlocuirea bazei implicite SQLite cu PostgreSQL (care poate găzdui simultan și tabelele pentru Postgres Chat Memory și extensia pgvector pentru RAG) și setarea obligatorie a variabilei N8N_ENCRYPTION_KEY (care criptează cheile API salvate în Credentials).

Dacă rulezi și Ollama pe același server pentru AI local, containerul n8n se poate conecta la Ollama folosind adresa internă http://host.docker.internal:11434 (sau numele serviciului http://ollama:11434 dacă sunt în aceeași rețea Docker Compose).

Cum să o reții ușor

💡 În loc să închiriezi cu ora o bucătărie străină unde plătești fiecare farfurie spălată, cu Docker îți instalezi propria linie automatizată în clădirea ta, conectată direct la propriul generator AI.

Opțiuni și parametri tehnici

  • N8N_ENCRYPTION_KEY: cheia secretă cu care sunt criptate credențialele (OpenAI, Gmail, DB) în baza de date. Fă-i backup obligatoriu!
  • WEBHOOK_URL: URL-ul public HTTPS (în spatele unui reverse proxy Nginx / Traefik / Cloudflare Tunnel) necesar pentru ca webhook-urile Telegram, Slack și OAuth2 să funcționeze corect.
  • GENERIC_TIMEZONE & TZ: setează-le pe Europe/Bucharest pentru ca nodurile Schedule Trigger și $now să respecte ora României.
  • EXECUTIONS_MODE=queue: mod avansat cu Redis în care procesul principal primește webhook-urile, iar mai multe containere n8n worker procesează agenții AI în paralel.

Exemple practice și cazuri de utilizare

  • Conectarea n8n din Docker la Ollama de pe mașina gazdă: adaugă extra_hosts: ["host.docker.internal:host-gateway"] în docker-compose.yml și folosește Base URL http://host.docker.internal:11434.
  • Actualizarea n8n la ultima versiune fără pierdere de date: docker compose pull && docker compose up -d (atât timp cât volumul /home/node/.n8n este persistent).
  • Activarea pachetelor npm externe în Code Node: adaugă NODE_FUNCTION_ALLOW_EXTERNAL=* în variabilele de mediu.

Sfaturi de configurare & capcane

Nu rula niciodată n8n în producție fără un volum persistent mapat pe /home/node/.n8n și fără o bază PostgreSQL regulat salvată în backup — pierderea lui N8N_ENCRYPTION_KEY face imposibilă decriptarea credențialelor salvate.

Comenzi și ghiduri înrudite