Stručné shrnutí: Spuštění n8n lokálně vyžaduje buď npm (Node.js 20.19-24.x) nebo Docker. Nejrychlejší metodou je použití npx n8n pro okamžité testování bez instalace, zatímco Docker poskytuje lepší izolaci a připravenost pro produkční nasazení. Obě metody vám poskytují plný přístup k možnostem automatizace pracovních postupů n8n bez opakujících se nákladů na cloud.
Nastavení n8n na lokálním stroji eliminuje opakující se poplatky za předplatné a zároveň poskytuje úplnou kontrolu nad automatizací pracovních postupů. Podle oficiální dokumentace n8n vyžaduje platforma pro instalace pomocí npm verzi Node.js mezi 20.19 a 24.x nebo Docker pro kontejnerizovaná nasazení.
Rozhodnutí mezi lokálním hostingem a cloudovými službami ovlivňuje rozpočet i flexibilitu. Podle diskusí v komunitě zvládnou lokální instalace neomezený počet pracovních postupů, zatímco cloudové plány zahrnují cenotvorbu založenou na počtu provedení (podle některých uživatelských zpráv začínající na 24 USD měsíčně za 2 500 provedení).
Předpoklady pro lokální instalaci
Před instalací n8n lokálně potřebuje systém specifický software v závislosti na zvolené metodě.
Požadovaná verze Node.js pro instalaci pomocí npm závisí zcela na specifických požadavcích verze n8n, kterou nasazujete, protože samotné npm je kompatibilní se všemi aktuálně podporovanými LTS verzemi Node.js. Oficiální dokumentace uvádí tento přesný rozsah verzí pro zajištění kompatibility. Aktuální verzi si ověříte spuštěním příkazu node –version v terminálu.
Instalace pomocí Dockeru vyžaduje Docker Engine nebo Docker Desktop. Tým n8n doporučuje Docker pro většinu potřeb self-hostingu, protože poskytuje čistou izolaci a zabraňuje nekompatibilitám s operačním systémem.
Systémové požadavky
Lokální instance n8n běží na systémech Windows, macOS a Linux. V oficiální dokumentaci není uvedena žádná minimální specifikace RAM, ale složitost pracovního postupu určuje skutečné potřeby zdrojů.
Instalace původně zabírá minimální místo na disku. Požadavky na úložiště rostou v závislosti na datech pracovních postupů, historii provádění a vlastních balíčcích uzlů.
Metoda 1: Spuštění n8n pomocí npm
Instalace pomocí npm poskytuje nejrychlejší cestu ke spuštění n8n lokálně. Tato metoda funguje přímo na hostitelském systému bez kontejnerizace.
Rychlé spuštění s npx
Nejjednodušší přístup používá npx bez trvalé instalace. Otevřete terminál a spusťte:
| npx n8n |
Tento příkaz stáhne vše potřebné a automaticky spustí n8n. Rozhraní se během několika sekund zpřístupní na adrese localhost:5678.
Metoda npx funguje perfektně pro testování a hodnocení. Nevyžaduje globální balíčky npm ani trvalé změny systému.
Globální instalace npm
Pro trvalou instalaci poskytuje globální balíček npm konzistentní přístup:
| npm install n8n -g |
Po dokončení instalace můžete n8n kdykoli spustit příkazem:
| n8n |
Aktuální hlavní stabilní verzí n8n je 2.x (např. 2.10.4). Beta verze mohou obsahovat nestabilní funkce a měly by být pro produkční pracovní postupy vynechány.
Konfigurace a ukládání dat
Instalace pomocí npm ukládají data pracovních postupů ve výchozím nastavení do adresáře ~/.n8n. Toto umístění obsahuje pověření, definice pracovních postupů a historii provádění.
Proměnné prostředí řídí chování n8n. Nastavte proměnnou N8N_PORT pro změnu výchozího portu 5678. Další proměnné konfigurují připojení k databázi, adresy URL webhooků a nastavení autentizace.
Metoda 2: Spuštění n8n pomocí Dockeru
Instalace pomocí Dockeru představuje doporučený přístup pro lokální hosting n8n. Oficiální dokumentace zdůrazňuje Docker pro potřeby produkčního self-hostingu.
Základní příkaz Docker Run
Spusťte n8n jediným příkazem Dockeru:
| docker run -it –rm –name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Tento příkaz vytvoří kontejner s názvem n8n, namapuje port 5678 na hostitele a uchovává data v adresáři ~/.n8n.
Kontejner běží interaktivně s příznakem -it. Odstraňte –rm, pokud chcete kontejner po zastavení zachovat.
Docker Compose pro produkční nasazení
Konfigurace Docker Compose poskytují lepší kontrolu pro produkční prostředí. Repozitář n8n-hosting na GitHubu obsahuje připravené soubory Docker Compose pro různé architektury.
Základní konfigurace docker-compose.yml vypadá takto:
| version: ‘3.8’ services: n8n: image: n8nio/n8n restart: always ports: – “5678:5678” environment: – N8N_BASIC_AUTH_ACTIVE=true – N8N_BASIC_AUTH_USER=admin – N8N_BASIC_AUTH_PASSWORD=password volumes: – ~/.n8n:/home/node/.n8n |
Spusťte stack příkazem:
| docker-compose up -d |
Příznak -d spustí kontejnery v odděleném režimu, což umožňuje použití terminálu pro jiné úkoly.
Počáteční konfigurace a přístup
Po spuštění n8n kteroukoli z metod se v prohlížeči webu přesuňte na localhost:5678. Na úvodní obrazovce nastavení se vyžádá e-mailová adresa a heslo pro administrátorský účet.
Tento první uživatel se stane vlastníkem instance s plnými administrativními právy. Další uživatelé mohou být přidáni později prostřednictvím rozhraní pro správu uživatelů.
Nastavení autentizace
Z bezpečnostních důvodů povolte autentizaci i na lokálních instalacích. Konfigurace Docker Compose přijímají proměnné prostředí pro autentizaci přímo:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
Tyto proměnné aktivují základní autentizaci HTTP, která vyžaduje pověření pro všechny pokusy o přístup.
Testování vlastních uzlů lokálně
Oficiální dokumentace vysvětluje, jak testovat vlastní uzly během vývoje. Nejprve nainstalujte n8n globálně, poté sestavte a propojte balíček vlastního uzlu.
V adresáři vlastního uzlu spusťte:
| npm run build npm link |
Poté přejděte do adresáře uzlů n8n (obvykle ~/.n8n/custom/) a propojte balíček:
| npm link <node-package-name> |
Vlastní uzel se po restartování instance objeví v rozhraní n8n.
Užitečné zdroje pro automatizaci k použití s n8n
Pokud se učíte, jak lokálně spustit n8n a testujete pracovní postupy na svém stroji, mohou vám být užiteční i externí pomocníci a šablony, které usnadňují automatizaci běžných úkolů. Get AI Perks nabízí knihovnu šablon pracovních postupů a nástrojů s asistencí AI, které můžete použít společně s n8n nebo k prototypování nápadů na automatizaci předtím, než je sami vytvoříte.
S Get AI Perks můžete:
- Začít s předpřipravenými šablonami pracovních postupů
- Získat asistenci AI pro rutinní logiku a obsah
- Prozkoumat běžné vzory automatizace před jejich implementací v n8n
- Kombinovat šablony s vaší lokální instalací n8n
Objevte Get AI Perks a najděte pomocníky pro automatizaci, kteří podporují vaše pracovní postupy n8n.
Řešení běžných problémů
Konflikty portů představují nejčastější problém při instalaci. Pokud je port 5678 již používán, buď zastavte konfliktní službu, nebo změňte port n8n pomocí proměnné prostředí N8N_PORT.
Nekompatibilita verze Node
Použití verzí Node.js mimo rozsah 20.19-24.x způsobuje selhání instalace. Repozitář n8n na GitHubu dokumentuje problémy, když se vývojáři pokoušejí o lokální vývojové prostředí, což zdůrazňuje důležitost kompatibility verzí Node.
Před řešením dalších problémů ověřte kompatibilitu verzí Node. Pokud je to nutné, přepínejte verze Node pomocí nvm (Node Version Manager).
Chyby oprávnění svazků Dockeru
Problémy s oprávněními u připojení svazku ~/.n8n brání trvalému ukládání dat. Kontejnery Dockeru běží jako uživatel node, který nemusí mít práva zápisu do adresáře hostitele.
Před spuštěním kontejneru vytvořte adresář s odpovídajícími oprávněními:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Často kladené otázky
Může n8n běžet bez přístupu k internetu?
Ano, n8n funguje zcela offline pro lokální pracovní postupy. Připojení k internetu je nutné pouze tehdy, když pracovní postupy interagují s externími API nebo cloudovými službami.
Kolik stojí spuštění n8n lokálně?
Lokální instalace jsou zdarma. Komunitní edice poskytuje všechny klíčové funkce bez licenčních poplatků. Cloudový hosting začíná s omezením provedení a měsíčními náklady, ale lokální hosting tyto omezení zcela odstraňuje podle diskusí v komunitě.
Měli by začátečníci používat npm nebo Docker?
Začátečníci, kteří testují n8n, by měli začít s npx pro okamžitý přístup. Docker dává větší smysl pro další používání, protože poskytuje lepší izolaci a snazší aktualizace.
Kde n8n lokálně ukládá data pracovních postupů?
Výchozí adresář pro data je ~/.n8n ve složce domovského uživatele. Toto umístění obsahuje soubory databáze SQLite, pověření a protokoly provádění, pokud není nakonfigurováno jinak.
Může na jednom stroji běžet více instancí n8n?
Ano, ale každá instance potřebuje unikátní port. Pro každou instanci nastavte různé porty pomocí proměnné prostředí N8N_PORT. Docker to usnadňuje prostřednictvím mapování portů v samostatných kontejnerech.
Jak fungují aktualizace pro lokální instalace?
Instalace npm se aktualizují pomocí příkazu npm update -g n8n nebo npm install -g n8n@latest. Uživatelé Dockeru si stáhnou nejnovější obraz pomocí příkazu docker pull n8nio/n8n a poté znovu vytvoří kontejnery. Před aktualizací si vždy zálohujte adresář ~/.n8n.
Produkční aspekty
Oficiální dokumentace n8n zdůrazňuje, že self-hosting vyžaduje technické znalosti. Nastavení serverů, správa zdrojů a zabezpečení aplikací vyžadují zkušenosti se systémovou správou.
Pro produkční nasazení poskytuje základ Docker Compose. Pro podporu HTTPS přidejte reverzní proxy, jako je nginx nebo Caddy. Repozitář n8n-hosting obsahuje konfigurační soubory Caddy připravené k nasazení.
Výběr databáze je pro náročné pracovní zátěže důležitý. Výchozí databáze SQLite funguje pro mírné použití, ale PostgreSQL nabízí lepší výkon pro vysoký objem automatizace podle oficiálních pokynů.
Rozhodnutí: Lokální vs. Cloud
Lokální hosting n8n je vhodný pro týmy s technickými schopnostmi a specifickými bezpečnostními požadavky. Data zůstávají na kontrolované infrastruktuře a limity provádění zmizí.
Lokální hosting však vyžaduje údržbu, zálohování a monitorování. Cloudový hosting přenáší tyto odpovědnosti na tým infrastruktury n8n. Aktuální ceny cloudových služeb a porovnání funkcí naleznete na oficiálních webových stránkách.
Spuštění n8n lokálně poskytuje úplnou kontrolu nad infrastrukturou automatizace pracovních postupů. Ať už používáte npm pro rychlé testování, nebo Docker pro produkční nasazení, obě metody poskytují kompletní platformu bez opakujících se nákladů. Začněte s npx pro okamžité prozkoumání a poté přejděte na Docker, když se pracovní postupy blíží k produkčnímu využití.
