n8n cez Docker – obrázkový návod

Čo budete potrebovať

Počítač s Macom (Apple Silicon alebo Intel) alebo Windowsom, prístup na internet a práva na inštaláciu programov.
Dosť voľného miesta na disku (obraz n8n má stovky MB) a pamäte RAM pre Docker Desktop. Presné požiadavky nájdete na stránke Dockeru.
Nič iné. Všetko spravíte klikaním v Docker Desktope.

Krok 1

Nainštalujte Docker Desktop

Docker je program, ktorý spustí n8n v oddelenom „kontajneri“, takže nemusíte nič inštalovať priamo do systému.

Otvorte docker.com a kliknite na Download Docker Desktop.
Vyberte svoj systém: Mac – Apple Silicon (čipy M1 a novšie), Mac – Intel, alebo Windows – AMD64 (bežný počítač). Verziu Macu zistíte cez ikonu jablka → O tomto Macu.
Otvorte stiahnutý súbor. Na Macu presuňte ikonu Dockeru do priečinka Aplikácie, na Windowse prejdite inštalátorom a po výzve počítač reštartujte.
Spustite Docker Desktop a odsúhlaste podmienky. Prihlásenie účtom nie je pre n8n potrebné, ak sa ponúka, môžete ho preskočiť.

docker.com

Develop Faster

Your foundation for secure, intelligent development

Download Docker Desktop

Download for Mac – Apple Silicon

Download for Mac – Intel Chip

Download for Windows – AMD64

Download for Windows – ARM64

Ilustrácia: tlačidlo Download Docker Desktop a výber systému.

Overenie: v Docker Desktope vľavo dole musí svietiť zelená ikona a text Engine running. Kým sa Docker nespustí, môže to trvať minútu.

Krok 2

Zistite svoju časovú zónu

n8n podľa nej spúšťa plánované workflowy (napríklad „každý pondelok o 8:00“). Bez nastavenia by bežali v čase UTC.

Otvorte na Wikipédii stránku List of tz database time zones.
V stĺpci TZ identifier nájdite svoje mesto. Použijete tento zápis.

Krajina	Zápis, ktorý použijete
Slovensko	`Europe/Bratislava`
Česko	`Europe/Prague`
Nemecko	`Europe/Berlin`

Zápis si poznačte, v kroku 5 ho vložíte do dvoch premenných.

Krok 3

Vytvorte úložisko pre dáta (volume)

Kontajner je dočasný: keď ho zmažete alebo aktualizujete, všetko vnútri zmizne. Volume je trvalé úložisko mimo kontajnera, v ktorom n8n drží vaše workflowy, prihlasovacie údaje a nastavenia.

V Docker Desktope vľavo otvorte Volumes.
Kliknite na Create (alebo New volume).
Do poľa s názvom napíšte presne n8n_data a potvrďte tlačidlom Create.

Docker Desktop

Containers

Images

Volumes

Builds

New Volume

Name your volume

n8n_data

Cancel Create

Ilustrácia: vytvorenie volume s názvom n8n_data.

Pozor na názov: v kroku 5 ho zadáte znova. Ak sa líšia, n8n sa spustí s prázdnym úložiskom a vaše dáta „nenájde“.

Krok 4

Stiahnite obraz n8n

Obraz (image) je hotový balík s n8n, ktorý Docker stiahne z registra.

Hore v Docker Desktope kliknite do vyhľadávacieho poľa a napíšte n8n.
V zozname vyhľadajte oficiálny obraz n8nio/n8n (hore, s najvyšším počtom stiahnutí, nad stovkou miliónov).
Vedľa neho nechajte tag latest a kliknite na Pull. Stiahnutie trvá zvyčajne do minúty.

Docker Desktop

n8n

n8nio/n8n 100M+ stiahnutílatest Pull Run

crazymax/n8n100K+

fedeiglesias/n8n4.1K

Ilustrácia: vyhľadanie n8n a tlačidlo Pull pri obraze n8nio/n8n.

Dávajte pozor, ktorý obraz berie: v zozname sú aj neoficiálne verzie od iných autorov. Správny je n8nio/n8n (v termináli docker.n8n.io/n8nio/n8n).

Krok 5

Spustite kontajner s nastaveniami

Vľavo otvorte Images, nájdite n8nio/n8n a kliknite na tlačidlo Run (trojuholník).
Rozbaľte Optional settings a vyplňte hodnoty podľa tabuľky nižšie.
Kliknite na Run.

Docker Desktop · Run a new container

Run a new container n8nio/n8n:latest

Container namen8n

Ports

Host port5678 → 5678/tcp

Volumes

Host pathn8n_data

Container path/home/node/.n8n

Environment variables

VariableGENERIC_TIMEZONE

ValueEurope/Bratislava

VariableTZ

ValueEurope/Bratislava

Cancel Run

Ilustrácia: okno Run a new container s vyplnenými hodnotami.

Pole	Hodnota	Na čo slúži
Container name	`n8n`	názov, podľa ktorého kontajner nájdete
Host port	`5678`	port, na ktorom n8n otvoríte v prehliadači
Volumes: host path	`n8n_data`	úložisko z kroku 3
Volumes: container path	`/home/node/.n8n`	miesto, kam n8n ukladá dáta
Variable `GENERIC_TIMEZONE`	vaša zóna, napr. `Europe/Bratislava`	časová zóna plánovaných workflowov
Variable `TZ`	tá istá zóna	časová zóna samotného kontajnera

Oficiálna dokumentácia n8n odporúča pridať ešte dve premenné. Pridajte ich tlačidlom + pri premenných:

Variable	Value
`N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS`	`true`
`N8N_RUNNERS_ENABLED`	`true`

Port už používa niečo iné? Ak je 5678 obsadený (napríklad druhou inštanciou n8n), zadajte do Host port iné číslo, napríklad 5679. Potom otvárate localhost:5679.

Krok 6

Otvorte n8n a vytvorte účet vlastníka

Vľavo otvorte Containers. Kontajner n8n musí mať stav Running (zelená bodka). Hneď po štarte chvíľu počkajte, kým sa n8n spustí.
V stĺpci Port(s) kliknite na odkaz 5678:5678, alebo v prehliadači otvorte http://localhost:5678.
Zobrazí sa stránka Set up owner account. Vyplňte e-mail, meno, priezvisko a heslo (aspoň 8 znakov, jedno číslo a jedno veľké písmeno) a kliknite na Next.
Ďalšie otázky n8n (o firme a o tom, na čo ho použijete) môžete preskočiť. Potom sa otvorí prázdne plátno a n8n je pripravený.

Docker Desktop · Containers

Containers

Images

Volumes

n8n n8nio/n8n:latestRunning · 5678:5678

Ilustrácia: bežiaci kontajner n8n.

localhost:5678/setup

Set up owner account

First Name

Last Name

Password

Ilustrácia: prvé prihlásenie, vytvorenie účtu vlastníka.

Hotovo. Účet je len vo vašej inštancii, nie v n8n cloude. Heslo si uložte do správcu hesiel.

Údržba

Ako n8n aktualizovať a zastaviť

Dáta sú vo volume n8n_data, takže kontajner môžete bez obáv vymeniť.

Zastavenie: v Containers kliknite pri n8n na štvorček (Stop). Spustíte ho trojuholníkom (Start). Po reštarte počítača a Dockeru spustite kontajner znova.
Aktualizácia: zastavte a zmažte kontajner n8n (ikona koša). Volume nemažte. Potom v Images znova stiahnite najnovší obraz (Pull) a opakujte krok 5 s rovnakými hodnotami.

Pred aktualizáciou si urobte zálohu: v n8n môžete workflowy exportovať (menu pri workflowe → Download). Nové verzie môžu meniť správanie niektorých uzlov.

Alternatíva

To isté jedným príkazom v termináli

Ak vám príkazový riadok nevadí, celý krok 3 až 5 nahradíte týmito dvoma príkazmi. Časovú zónu vymeňte za svoju.

docker volume create n8n_data

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

Voči príkladu z dokumentácie n8n je tu pridané -d (beh na pozadí) a --restart unless-stopped (kontajner sa po reštarte Dockeru spustí sám) a vynechané --rm, ktoré by kontajner po zastavení zmazalo.

Keď niečo nejde

Najčastejšie problémy

Príznak	Čo skúsiť
Stránka localhost:5678 sa nenačíta	Skontrolujte, či je Docker Desktop spustený a kontajner n8n má stav Running. Hneď po štarte počkajte pol minúty. Otvorte záložku Logs v kontajneri a pozrite posledné riadky.
Kontajner sa nespustí, port je obsadený	Zmeňte Host port na iné číslo (napr. 5679) alebo zastavte program, ktorý port používa.
Po aktualizácii zmizli workflowy	Pri novom kontajneri ste nepripojili volume n8n_data alebo ste zadali iný názov. Kontajner zmažte a spustite znova s volume z kroku 3.
Plánovanie beží v nesprávnom čase	Skontrolujte premenné GENERIC_TIMEZONE a TZ (správny zápis napr. Europe/Bratislava) a kontajner vytvorte znova.
Webhooky z internetu nechodia	n8n na localhost nie je dostupný zvonka. Na prijímanie webhookov z internetu treba tunel (napr. Cloudflare Tunnel alebo ngrok), alebo n8n nasadiť na server.

n8n na vlastnom počítači cez Docker Desktop

Čo budete potrebovať

Nainštalujte Docker Desktop

Zistite svoju časovú zónu

Vytvorte úložisko pre dáta (volume)

New Volume

Stiahnite obraz n8n

Spustite kontajner s nastaveniami

Run a new container n8nio/n8n:latest

Otvorte n8n a vytvorte účet vlastníka

Set up owner account

Ako n8n aktualizovať a zastaviť

To isté jedným príkazom v termináli

Najčastejšie problémy