n8n na Windows: instalacja na własnym komputerze w 10 minut (Docker Desktop albo npx)

Na Windows n8n uruchomisz na dwa sposoby. Oba są darmowe, a interfejs otwierasz w przeglądarce pod adresem http://localhost:5678.

| Sposób | Czas | Dla kogo | Co musisz mieć |
| --- | --- | --- | --- |
| Docker Desktop (zalecany) | ok. 10 minut, w tym instalacja Dockera | Każdy, kto chce trzymać workflow na dłużej | Windows 10/11 64-bit, WSL 2, włączona wirtualizacja |
| npx / npm (Node.js) | ok. 3 minuty | Szybki test, jedno popołudnie zabawy | Node.js w wersji obsługiwanej przez n8n |

Docker trzyma n8n w odizolowanym kontenerze, a dane w osobnym wolumenie, więc aktualizacja i kopia zapasowa to dwa polecenia. Wersja przez Node.js startuje szybciej, ale trudniej ją utrzymać: przy aktualizacji Node.js lub n8n częściej coś się rozjeżdża.

Jedno zastrzeżenie na start: n8n na komputerze działa tylko wtedy, gdy komputer jest włączony i nie śpi. Do nauki, testów i automatyzacji „na żądanie” to wystarcza. Jeśli workflow mają chodzić całą dobę albo przyjmować webhooki z internetu, zajrzyj do sekcji 9.

Sprzęt i system

• Windows 10 w wersji 22H2 albo Windows 11, w obu przypadkach 64-bit.
• 8 GB RAM to rozsądne minimum. Samo n8n zużywa kilkaset MB, ale Docker Desktop uruchamia lekką maszynę wirtualną WSL 2, która też potrzebuje pamięci. Więcej o zużyciu pamięci przez n8n piszemy w poradniku Ile RAM potrzebuje n8n?.
• Około 10 GB wolnego miejsca na dysku.
• Włączona wirtualizacja w BIOS/UEFI (Intel VT-x albo AMD-V). Na większości nowych komputerów jest włączona fabrycznie.

Jak sprawdzić wirtualizację

Otwórz Menedżer zadań (Ctrl + Shift + Esc), przejdź do zakładki Wydajność i kliknij Procesor. Pod wykresem zobaczysz pole Wirtualizacja: Włączone. Jeśli widzisz „Wyłączone”, włącz ją w ustawieniach BIOS/UEFI (opcja zwykle nazywa się Intel Virtualization Technology, SVM Mode albo AMD-V).

Licencja i koszty

Samodzielnie hostowane n8n (Community Edition) jest bezpłatne do własnego użytku, w tym do automatyzacji we własnej firmie. Docker Desktop jest bezpłatny do użytku prywatnego, edukacji i w małych firmach. Duże firmy potrzebują płatnej subskrypcji Dockera, więc warto sprawdzić aktualne warunki na stronie producenta.

Krok 1. Włącz WSL 2

Otwórz PowerShell jako administrator (prawy klik na Start → Terminal (Administrator)) i wpisz:

wsl --install

Polecenie włącza WSL 2 i instaluje domyślną dystrybucję Linuksa. Po zakończeniu uruchom komputer ponownie. Jeśli WSL jest już zainstalowany, zaktualizuj go poleceniem wsl --update.

Krok 2. Zainstaluj Docker Desktop

Pobierz instalator ze strony docker.com i uruchom go. Zostaw zaznaczoną opcję Use WSL 2 instead of Hyper-V. Po instalacji uruchom Docker Desktop i poczekaj, aż w lewym dolnym rogu pojawi się zielony status Engine running.

Sprawdź w zwykłym PowerShellu, czy Docker odpowiada:

docker --version
docker run --rm hello-world

Jeśli drugie polecenie wypisze „Hello from Docker!”, wszystko działa.

Krok 3. Utwórz wolumen na dane

Wolumen to miejsce, w którym Docker trzyma bazę n8n, zapisane workflow i zaszyfrowane dane logowania. Dzięki niemu nic nie zginie po usunięciu lub aktualizacji kontenera.

docker volume create n8n_data

Krok 4. Uruchom n8n

docker run -d --name n8n --restart unless-stopped -p 5678:5678 -e GENERIC_TIMEZONE="Europe/Warsaw" -e TZ="Europe/Warsaw" -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

Co robią poszczególne części:

| Fragment | Znaczenie |
| --- | --- |
| -d | Kontener działa w tle, możesz zamknąć okno PowerShella |
| --restart unless-stopped | n8n wstaje samo po restarcie Dockera lub komputera |
| -p 5678:5678 | Port 5678 kontenera jest dostępny na Twoim komputerze |
| GENERIC_TIMEZONE i TZ | Harmonogramy (węzeł Schedule Trigger) liczą czas według polskiej strefy |
| -v n8n_data:/home/node/.n8n | Dane n8n trafiają do wolumenu z kroku 3 |

Pierwsze uruchomienie pobiera obraz, co przy szybkim łączu trwa minutę lub dwie.

Krok 5. Otwórz n8n w przeglądarce

Wejdź na http://localhost:5678. Przy pierwszym wejściu n8n poprosi o utworzenie konta właściciela (e-mail, imię, hasło). To konto lokalne: dane zostają w Twoim wolumenie i nie są wysyłane do chmury n8n.

Na tym etapie masz działające n8n. Możesz od razu zbudować pierwszy workflow.

Długie polecenie z kroku 4 łatwo pomylić przy aktualizacji. Wygodniej zapisać konfigurację w pliku. Utwórz folder, na przykład C:\n8n, a w nim plik docker-compose.yml:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=Europe/Warsaw
      - TZ=Europe/Warsaw
      - N8N_DEFAULT_BINARY_DATA_MODE=filesystem
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=168
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:
    external: true

Dwie dodatkowe zmienne pomagają oszczędzać pamięć i dysk. N8N_DEFAULT_BINARY_DATA_MODE=filesystem zapisuje pliki (obrazy, PDF-y) na dysku zamiast trzymać je w RAM, a EXECUTIONS_DATA_MAX_AGE=168 usuwa historię wykonań starszą niż 7 dni.

Jeśli wcześniej uruchomiłeś kontener poleceniem z kroku 4, najpierw go usuń. Dane w wolumenie zostaną:

docker rm -f n8n
cd C:\n8n
docker compose up -d

Wpis external: true mówi Dockerowi, żeby użył istniejącego wolumenu n8n_data, a nie tworzył nowego, pustego.

Ta droga nie wymaga Dockera. Sprawdza się, gdy chcesz tylko obejrzeć n8n.

Krok 1. Zainstaluj Node.js

Pobierz wersję LTS ze strony nodejs.org i zainstaluj z domyślnymi opcjami. n8n obsługuje tylko określone wersje Node.js. Aktualny zakres znajdziesz w dokumentacji instalacji przez npm. Najbezpieczniej wybrać aktualną wersję LTS.

Sprawdź instalację w nowym oknie PowerShella:

node --version
npm --version

Krok 2. Uruchom n8n

npx n8n

Przy pierwszym uruchomieniu npx pobierze n8n, co może potrwać kilka minut. Gdy w terminalu pojawi się informacja, że edytor jest dostępny, otwórz http://localhost:5678. Zamknięcie okna PowerShella zatrzymuje n8n.

Instalacja na stałe

Jeśli chcesz uruchamiać n8n krótszym poleceniem, zainstaluj je globalnie:

npm install n8n -g
n8n start

W tej wersji dane trafiają do folderu .n8n w katalogu Twojego użytkownika (%USERPROFILE%). Tam jest baza SQLite i plik config z kluczem szyfrującym. Ten folder trzeba objąć kopią zapasową.

Strefę czasową ustawisz przed startem:

$env:GENERIC_TIMEZONE = "Europe/Warsaw"
n8n start

Co jest w danych n8n

W wolumenie (albo w folderze .n8n) leżą: baza z workflow i historią wykonań, zaszyfrowane dane logowania do usług oraz klucz szyfrujący. Bez tego klucza zapisanych haseł i tokenów nie da się odczytać nawet z pełną kopią bazy. Kopiuj zawsze całość, nie samą bazę.

Kopia wolumenu Dockera

Zatrzymaj n8n, spakuj wolumen do pliku w bieżącym folderze i uruchom n8n ponownie:

docker stop n8n
docker run --rm -v n8n_data:/data -v ${PWD}:/backup alpine tar czf /backup/n8n_data_backup.tgz -C /data .
docker start n8n

W bieżącym folderze pojawi się plik n8n_data_backup.tgz. Przenieś go na inny dysk albo do chmury.

Aktualizacja w Dockerze

W folderze z plikiem docker-compose.yml:

docker compose pull
docker compose up -d

Docker pobierze nowy obraz i odtworzy kontener. Dane zostają w wolumenie. Przed dużą aktualizacją, na przykład przy zmianie głównego numeru wersji, zrób kopię i przeczytaj informacje o zmianach w wydaniu.

Aktualizacja wersji npm

npm update -g n8n

| Objaw | Przyczyna | Rozwiązanie |
| --- | --- | --- |
| Docker Desktop pokazuje „WSL 2 is not installed” lub nie startuje | Brak lub stara wersja WSL | wsl --install albo wsl --update w PowerShellu jako administrator, potem restart |
| „Virtualization support not detected” | Wirtualizacja wyłączona w BIOS/UEFI | Włącz Intel VT-x / AMD-V (sekcja 2) |
| „port is already allocated” albo „address already in use” | Port 5678 zajmuje inny program lub stary kontener | Sprawdź netstat -ano i znajdź port 5678, albo zmień mapowanie na -p 5679:5678 i otwórz http://localhost:5679 |
| „npx.ps1 cannot be loaded because running scripts is disabled” | Zasady wykonywania skryptów w PowerShellu | Użyj npx.cmd n8n albo uruchom polecenie w Wierszu polecenia (cmd) |
| Harmonogram odpala się godzinę lub dwie za wcześnie | Brak strefy czasowej | Ustaw GENERIC_TIMEZONE=Europe/Warsaw i odtwórz kontener |
| Po aktualizacji zniknęły workflow | Kontener uruchomiony bez wolumenu lub z nowym, pustym wolumenem | Uruchom kontener z -v n8n_data:/home/node/.n8n; nazwę wolumenu sprawdzisz poleceniem docker volume ls |
| Credentials przestały działać po przeniesieniu danych | Inny klucz szyfrujący | Przenieś cały folder .n8n lub cały wolumen, razem z plikiem config |
| Komputer zwalnia, gdy działa Docker | WSL 2 zajmuje dużo RAM | Ogranicz pamięć w pliku .wslconfig (sekcja 8) |

Samo n8n przy kilku prostych workflow potrzebuje zwykle kilkuset MB RAM. Na Windows więcej pamięci zabiera warstwa pod spodem: Docker Desktop działa w maszynie wirtualnej WSL 2, która domyślnie może zająć sporą część pamięci komputera.

Jeśli komputer ma 8–16 GB RAM i zauważasz spowolnienie, ogranicz WSL 2. Utwórz w katalogu użytkownika (%USERPROFILE%) plik .wslconfig z treścią:

[wsl2]
memory=4GB
processors=2

Następnie zamknij Docker Desktop, wpisz w PowerShellu wsl --shutdown i uruchom Docker Desktop ponownie. 4 GB w zupełności wystarczy dla n8n i kilku innych kontenerów.

Jeśli obok n8n chcesz uruchomić lokalny model AI, lepiej zainstalować go bezpośrednio w Windows, a nie w Dockerze. Opisujemy to w poradniku Ollama na Windows. n8n w kontenerze połączy się z Ollamą pod adresem http://host.docker.internal:11434.

Lokalne n8n ma trzy ograniczenia, które w końcu zaczynają przeszkadzać:

1. Działa tylko, gdy komputer jest włączony. Uśpienie lub wyłączenie zatrzymuje harmonogramy. Pominięte uruchomienia nie są nadrabiane.
2. Webhooki z internetu do niego nie dotrą. Adres localhost widzi tylko Twój komputer. Usługi takie jak formularze, płatności czy Facebook nie wyślą zdarzeń do lokalnego n8n bez tunelu (na przykład Cloudflare Tunnel) i dodatkowej konfiguracji.
3. Kopie zapasowe i aktualizacje są po Twojej stronie. Na komputerze łatwo o nie zapomnieć.

Gdy automatyzacje mają działać całą dobę, najprostszy krok to mały serwer VPS. Wystarczy plan z 2 GB RAM. Przeniesienie polega na skopiowaniu wolumenu z sekcji 6 na serwer, a całą instalację z certyfikatem SSL opisujemy w poradniku n8n na VPS z Dockerem i Caddy. Jeśli wolisz Linuksa na własnym sprzęcie, zobacz lokalną instalację n8n na Ubuntu.

Poniżej znajdziesz odpowiedzi na najczęstsze pytania o instalację n8n na Windows.

Najpewniejsza droga do n8n na Windows to Docker Desktop z WSL 2: jeden wolumen na dane, jedno polecenie na start i dwa na aktualizację. Wersja przez npx n8n nadaje się do szybkiego testu. W obu przypadkach ustaw polską strefę czasową, rób kopię całych danych razem z kluczem szyfrującym i pamiętaj, że lokalne n8n działa tylko wtedy, gdy działa komputer.

Źródła i dalsza lektura

• n8n: instalacja w Dockerze
• n8n: instalacja przez npm
• n8n: zmienne środowiskowe
• Microsoft: instalacja WSL
• Docker: Docker Desktop na Windows
• Brodatech Stack: Ile RAM potrzebuje n8n?
• Brodatech Stack: n8n na VPS z Dockerem i Caddy

Wymagania systemowe Dockera i obsługiwane wersje Node.js zmieniają się z kolejnymi wydaniami. Aktualne wartości sprawdź w dokumentacji producenta.