Jak zainstalować n8n: Docker, serwer i pierwsze kroki

n8n można używać w chmurze producenta albo zainstalować na własnym serwerze. Ta druga opcja, tzw. self-hosted, daje kontrolę nad danymi i nie ma opłat za wykonania przepływów, dlatego wybiera ją wiele firm. W tym przewodniku pokazujemy, jak zainstalować n8n: najpierw szybko, do testów, a potem tak, żeby można było na nim oprzeć procesy firmy.

Przewodnik zakłada podstawową znajomość wiersza poleceń i Dockera. Jeśli nie wiesz jeszcze, czym jest n8n i czy pasuje do waszej firmy, zacznij od artykułu n8n: co to jest i jak działa.

Zanim zaczniesz: cztery decyzje

Instalacja techniczna to najprostsza część. Zanim ją zaczniesz, warto odpowiedzieć na kilka pytań, bo od nich zależy, czy w ogóle potrzebujesz własnego serwera:

1. 1Gdzie mają być dane? Jeśli przepływy będą przetwarzać dane osobowe lub finansowe, które nie powinny trafiać do zewnętrznej usługi, własny serwer w UE ma sens.
2. 2Ile będzie wykonań? Przy dużej liczbie uruchomień przepływów własny serwer zwykle wychodzi taniej niż abonament w chmurze.
3. 3Kto będzie utrzymywał serwer? Aktualizacje, kopie i reakcja na awarie to stała praca, a nie jednorazowe zadanie.
4. 4Z jakimi systemami n8n ma się łączyć? Systemy w sieci firmowej, np. ERP na serwerze w biurze, łatwiej podłączyć do n8n zainstalowanego blisko nich.

Jeśli odpowiedzi wskazują, że nie potrzebujesz własnego serwera, n8n Cloud oszczędzi ci pracy. Różnice opisujemy w artykule n8n cennik.

Trzy sposoby na uruchomienie n8n

Istnieje też instalacja przez npm, ale do pracy w firmie zalecamy Dockera. Łatwiej go aktualizować, przenosić i odtwarzać po awarii.

Szybki test n8n w Dockerze

Jeśli masz na komputerze Dockera, n8n uruchomisz dwoma poleceniami. Pierwsze tworzy wolumen, w którym n8n zapisze dane, drugie uruchamia kontener:

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

Po chwili otwórz w przeglądarce adres http://localhost:5678, załóż konto właściciela i możesz budować pierwszy przepływ. Dane zostaną w wolumenie n8n_data, więc po ponownym uruchomieniu kontenera nic nie zniknie.

Instalacja n8n na serwerze dla firmy

Do pracy w firmie potrzebujesz kilku rzeczy więcej:

1. 1Serwera, zwykle niewielkiego VPS w centrum danych w UE, z zainstalowanym Dockerem i Docker Compose.
2. 2Domeny lub subdomeny, np. n8n.twojafirma.pl, skierowanej na adres serwera.
3. 3Bazy PostgreSQL zamiast domyślnego SQLite, bo lepiej znosi większą liczbę wykonań i łatwiej robić jej kopie.
4. 4Stałego klucza szyfrującego, którym n8n szyfruje zapisane dane dostępowe do systemów.
5. 5Serwera pośredniczącego (reverse proxy), np. Caddy, Traefik lub Nginx, który obsłuży certyfikat HTTPS.

Plik docker-compose.yml

Poniżej przykładowa konfiguracja, która uruchamia n8n razem z bazą PostgreSQL. Hasło, klucz szyfrujący i domenę zamień na własne:

services:
  postgres:
    image: postgres:16
    restart: always
    environment:
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=zmien-to-haslo
      - POSTGRES_DB=n8n
    volumes:
      - db_data:/var/lib/postgresql/data
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=zmien-to-haslo
      - N8N_ENCRYPTION_KEY=dlugi-losowy-klucz
      - N8N_HOST=n8n.twojafirma.pl
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://n8n.twojafirma.pl/
      - GENERIC_TIMEZONE=Europe/Warsaw
      - TZ=Europe/Warsaw
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres
volumes:
  db_data:
  n8n_data:

Kilka zmiennych wymaga wyjaśnienia:

• N8N_ENCRYPTION_KEY to klucz, którym n8n szyfruje dane dostępowe. Zapisz go w bezpiecznym miejscu. Bez niego po odtworzeniu z kopii n8n nie odczyta zapisanych haseł i tokenów.
• WEBHOOK_URL to publiczny adres n8n. Na jego podstawie n8n generuje adresy webhooków, które podajesz innym systemom.
• GENERIC_TIMEZONE ustawia strefę czasową dla harmonogramów, żeby przepływ „codziennie o 7:00” startował o 7:00 polskiego czasu.
• Port n8n jest wystawiony tylko lokalnie, a ruch z internetu przechodzi przez reverse proxy z HTTPS.

Uruchomienie całości to jedno polecenie wydane w katalogu z plikiem:

docker compose up -d

Po skonfigurowaniu reverse proxy i certyfikatu n8n będzie dostępny pod adresem https://n8n.twojafirma.pl. Pierwsza osoba, która go otworzy, zakłada konto właściciela, więc zrób to od razu po uruchomieniu.

Bezpieczeństwo po instalacji

n8n ma dostęp do systemów firmy, więc jego bezpieczeństwo jest ważne. Po instalacji:

• ustaw silne hasła i osobne konta dla każdej osoby, bez wspólnego konta administratora,
• ogranicz dostęp do serwera, np. zaporą i logowaniem przez klucze SSH zamiast haseł,
• regularnie aktualizuj system operacyjny serwera,
• trzymaj klucz szyfrujący i hasło do bazy poza serwerem, w menedżerze haseł,
• jeśli n8n nie musi być dostępny z internetu, udostępnij go tylko przez VPN, a z zewnątrz otwórz wyłącznie webhooki.

Przy przetwarzaniu danych osobowych pamiętaj też o obowiązkach z RODO, o których piszemy w artykule RODO a automatyzacja procesów.

Kopie zapasowe

Najważniejsze są dwie rzeczy: baza danych, w której są przepływy, historia wykonań i zaszyfrowane dane dostępowe, oraz klucz szyfrujący. Kopię bazy możesz wykonać poleceniem:

docker compose exec postgres pg_dump -U n8n n8n > n8n-kopia.sql

Takie polecenie warto uruchamiać automatycznie, np. codziennie w nocy, a kopie przechowywać poza serwerem. Co jakiś czas sprawdź, czy z kopii da się odtworzyć działające n8n. Kopia, której nikt nie przetestował, często okazuje się bezużyteczna w dniu awarii.

Aktualizacje n8n

n8n rozwija się szybko i nowe wersje pojawiają się często. Aktualizacja w Docker Compose to pobranie nowego obrazu i ponowne uruchomienie kontenerów:

docker compose pull
docker compose up -d

Przed aktualizacją zrób kopię bazy i przeczytaj listę zmian, szczególnie przy większych wersjach, które mogą zmieniać działanie węzłów. W firmie lepiej przypiąć konkretną wersję obrazu w pliku konfiguracyjnym i aktualizować ją świadomie, niż zawsze pobierać najnowszą.

Najczęstsze problemy po instalacji

• Webhooki nie działają albo mają adres localhost. Sprawdź, czy zmienna WEBHOOK_URL zawiera publiczny adres z https i czy reverse proxy przekazuje ruch do n8n.
• Przepływy startują o złej godzinie. Ustaw GENERIC_TIMEZONE na Europe/Warsaw i uruchom kontener ponownie.
• Po przeniesieniu na nowy serwer zniknęły dane dostępowe. n8n działa z innym kluczem szyfrującym niż wcześniej. Przywróć oryginalny N8N_ENCRYPTION_KEY.
• Szybko kończy się miejsce na dysku. Historia wykonań rośnie z każdym uruchomieniem. Włącz jej automatyczne czyszczenie zmiennymi EXECUTIONS_DATA_PRUNE i EXECUTIONS_DATA_MAX_AGE.
• n8n zwalnia przy wielu przepływach. Sprawdź zasoby serwera, a przy dużej liczbie wykonań rozważ tryb kolejki.

Pierwszy przepływ po instalacji

Na początek wybierz prosty, ale prawdziwy proces, np. zapis zapytań z formularza na stronie w CRM z powiadomieniem dla handlowca. Taki przepływ szybko pokaże, czy webhooki, dane dostępowe i strefa czasowa są ustawione dobrze, a jednocześnie od razu da firmie korzyść. Jak taki proces wygląda w pełnej wersji, opisujemy na stronie obsługa zapytań ofertowych.

Gdy podstawowe przepływy działają stabilnie, możesz sięgnąć po AI: odczyt dokumentów, klasyfikację maili albo agentów, o których piszemy na stronie agenci AI w n8n.

Co dalej po instalacji

Działająca instalacja to dopiero początek. Żeby n8n było pewnym elementem firmy, potrzebujesz jeszcze:

• monitoringu, który powiadomi cię, gdy przepływ zakończy się błędem albo serwer przestanie odpowiadać,
• przepływów obsługujących błędy, żeby problemy nie znikały po cichu,
• porządku w nazwach i dokumentacji przepływów,
• przy większej liczbie wykonań trybu kolejki (queue mode) z osobnymi procesami roboczymi.

Koszty serwera i utrzymania porównujemy z n8n Cloud w artykule n8n cennik. Jeśli wolicie, żeby instalacją i opieką zajął się ktoś inny, zobaczcie, jak robimy to na stronie n8n self-hosted, a całą ofertę wdrożeń na stronie wdrożenie n8n. Gdy instalacja już działa, ale przepływy sprawiają problemy, pomożemy przy opiece nad n8n.