ELO Wiki

Seite bearbeiten und [Speichern] drücken. Siehe syntax zur Wiki-Syntax. Bitte nur editieren, falls das Dokument tatsächlich verbessert werden kann. Zum Testen bitte erst im Spielplatz üben.

====== Installation von N8N ======

===== Von 0 auf 100 =====

Hat man hier bereits node.js installiert (Version 20+) im aktuellen Release zum Stand 22.03.2026, dann kann man hier einfacherweise Folgendes machen.

* npm install -g n8n@latest
  * n8n

Wenn alles passt, dann startet hier N8N auf dem Loopback und wird im Terminal bzw. durch den ausführenden Prozess ausgeführt.

===== PM2 ======

Für einen Dauerbetrieb ist oben angeführter Weg noch nicht der Idealfall. Nach dem Neustart des OS müsste man immer wieder einsteigen und n8n manuell ausführen. Hier kann ein Servicerunner Abhilfe schaffen. Bspw. Definition eines .service Files in Linux, Einbettung von nssm unter Windows. Die Onboard Alternative von node.js ist aber PM2. PM steht für Process Manager. Dieser Artikel behandelt das Vorgehen ausführlich: https://netbird.io/knowledge-hub/install-n8n-v2-npm. Der PM2 kann hier mehrere "Dienstinstanzen" separat behandeln. Folgende Befehle sind die wohl Gängisten rund um die Einrichtung.

<code>
nano ~/n8n.config.js

# n8n Dienst starten mit Config
pm2 start ~/n8n.config.js

# SystemD Registrierung
pm2 startup

# N8N starten
pm2 start n8n

# N8n stoppen
pm2 stop n8n
</code>

Bei PM2 sollte man hier im Hinterkopf behalten, dass hier die Config-Datei im internen Repository vorhanden bleibt. Ein Refresh der Config-Datei kann wiederum mit pm2 start <configfile> passieren. Eine längere Abhandlung über das Thema findet sich hier: https://stackoverflow.com/questions/44508316/reload-pm2-configuration-file

===== Windows, Linux oder Docker =====

Soll man eher hier Windows, Linux oder Docker verwenden. Das ist hier immer die Frage was man wie erreichen will. Alle drei Einrichtungsvarianten gehen hier mehr oder weniger sehr unkompliziert. Docker ist vielleicht die einfachste Variante.

* Installiert man mit NPM unter Windows: kann ggf. zu kleineren Überraschungen führen trotz aktuellsten Versionen
  * Installiert man mit NPM unter Linux: kann hier ebenfalls Probleme und Bauchschmerzen bereiten, siehe Vorbereitung Debian 13
  * Docker: hier ist halt ein wenig Basiswissen rund um Docker von Vorteil.
    * Allen voran: wie startet/stoppt man Container
    * Welche Plattformen bietet der Host an (bspw. Docker CE auf Server-OS Windows kann nur Windows Container)
    * Wie baut man docker-compose.yml Files auf

Ansonsten ist hier die Frage:
   * sind externe Programme direkt aufzurufen/anzubinden: hier ist dann, außer man will die Programme wiederum mit einem "HTTP/REST Container" kapseln, die richtige OS-Wahl von Vorteil. Wenn es sich hier um ein Windows-Programm handelt, macht hier eine Windows Installation Sinn.   
   * will man extern dazu entwickeln? Hier macht dann die Plattform Sinn, die man hier auch nutzt. N8N hat hier den Vorteil, dass es hier leichtgewichtig ist. Der Host-Prozess verschlingt hier gerade einmal 30 MB Memory bei "Initialsetting". Wenn man hier also das primäre Entwicklungssystem und alle Tools auf Windows hat, macht eine Installation unter Windows natürlich schon Sinn. Umgekehrt gesehen, wenn man sein Entwicklungssystem auf Linux hat.

===== Debian 13 Vorbereitung =====

Der sauberste Weg ist hier immer jener das externe Repository nodesource.com einzubinden. Die Standard-Repositories von Debian können hier teilweise sehr alte Node.js Verweise enthalten.

<code>
# in den Root Modus (sudo kann klappen, muss es aber nicht)
su -

# CURL Installation
apt-get install -y curl

# NodeJS 22 installieren
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -

# Installation von NodeJS/NPM
apt-get install -y nodejs
apt-get install -y npm

node --version
npm --version
</code>

===== Debian 13 Cleanup =====

Hat man hier schon einen Irrweg beschritten mit alten Node.js Paketen und vielleicht auch schon begonnen einmal N8N herunterzuladen, kann es sein, dass der Cache eher ein wenig durcheinander ist und man hier von einen Fehler in den anderen läuft. Man bekommt dann bspw. folgenden Fehler:

<code>
Can you explain how to resolve n8n error : Error: Cannot find module 'semver/functions/satisfies'
</code>

Man kann hier dem entsprechend mit KI versuchen sich ein Skript bauen zu lassen (bspw. Codex, Gemini, etc.) bevor man wieder n8n installieren lässt.

<code>
npm uninstall -g n8n semver
sudo rm -rf /usr/local/lib/node_modules/n8n /usr/local/lib/node_modules/semver
npm cache verify
npm install -g n8n@latest
n8n --version
</code>

Zusammenfassung

Hinweis: Durch das Bearbeiten dieser Seite geben Sie Ihr Einverständnis, dass Ihr Inhalt unter der folgenden Lizenz veröffentlicht wird: CC Attribution-Share Alike 4.0 International