Nod am Mac installieren
- Prüfe unter Apple-Menü → Über diesen Mac, ob dort „Chip“ (Apple Silicon) oder „Prozessor“ (Intel) steht.
- Lade die passende DMG-Datei aus den Releases auf GitHub:
nod-arm64.dmg für Apple Silicon, nod-x64.dmg für Intel.
- Öffne die DMG, zieh Nod in den Ordner Programme und starte es von dort.
- Beim ersten Öffnen fragt macOS, ob du eine App aus dem Internet öffnen willst. Wähle Öffnen.
- Auf dem Willkommensbildschirm wählst du Get started für einen Assistenten auf diesem Rechner oder Connect to a server, wenn du schon einen Nod-Server hast.
- Fragt macOS nach deinem Schlüsselbund-Passwort, bestätige es. Damit schützt Nod laut Doku deine gespeicherten Schlüssel.
Statt der DMG kannst du laut Doku auch einen Befehl im Terminal nehmen. Beende Nod vorher und führe ihn als normaler Nutzer aus, ohne sudo:
(
installer="$(mktemp)" || exit
trap 'rm -f "$installer"' EXIT
curl -q --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/n8n-io/nod/main/deployment/n8n/install.sh -o "$installer" && /bin/sh "$installer"
)
Das Skript sucht laut Doku die neueste Version auf GitHub, prüft die heruntergeladene App, installiert sie nach /Applications/Nod.app und öffnet sie. Ein GitHub-Konto brauchst du nicht, vorhandene Daten bleiben erhalten. Das Skript selbst lädt der Befehl direkt aus dem Hauptzweig auf GitHub, nicht aus einer festen Version. Wer das nicht will, nimmt die DMG.
Nod unter Windows installieren (Vorschau)
- Lade
nod-Setup-x64.exe aus den Releases auf GitHub.
- Starte den Installer. Als Herausgeber zeigt Windows laut Doku n8n GmbH an; SmartScreen kann bei einer neuen Version trotzdem warnen.
- Wähle Get started oder Connect to a server.
- Braucht Nod WSL, folge den Hinweisen und bestätige die Administrator-Anfrage. Verlangt Windows einen Neustart, öffne Nod danach wieder; deine Verbindungen und Einstellungen bleiben laut Doku erhalten.
Alternativ beendest du Nod und installierst es in einem normalen PowerShell-Fenster (Windows PowerShell 5.1 oder PowerShell 7), nicht als Administrator:
irm https://raw.githubusercontent.com/n8n-io/nod/main/deployment/n8n/install.ps1 | iex
Auch dieses Skript kommt aus dem Hauptzweig; der Installer aus den Releases ist der vorsichtigere Weg.
Nod unter Linux installieren (Flatpak-Vorschau)
Für Linux gibt es laut Doku nur eine Vorschau als Flatpak für x64, keine ARM-Builds. Weil GitHub einzelne Release-Dateien auf 2 GiB begrenzt, ist das Paket in nummerierte Teile zerlegt.
Installiere Flatpak über deine Paketverwaltung und füge Flathub hinzu:
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
Öffne die Releases von Nod, wähle eine Version mit Linux-Dateien und lade alle Dateien nod-linux-x64.flatpak.partNN sowie SHA256SUMS-linux-x64 in einen leeren Ordner.
Füge die Teile in diesem Ordner zusammen, prüfe sie und installiere das Paket. Der letzte Schritt läuft nur, wenn alle Prüfsummen stimmen:
cat nod-linux-x64.flatpak.part[0-9][0-9] > nod-linux-x64.flatpak && \
sha256sum --check SHA256SUMS-linux-x64 && \
flatpak install --user ./nod-linux-x64.flatpak
Starte Nod aus dem Anwendungsmenü oder mit flatpak run io.n8n.Nod.
Halte deinen Schlüsselspeicher während der Einrichtung entsperrt. Ohne sicheren Speicher speichert Nod laut Doku keine Schlüssel.
Erster Start: die Einrichtung
Gleich nach dem Willkommensbildschirm beginnt Nod, seinen eigenen Rechner vorzubereiten, und zeigt den Fortschritt an. Lass die Internetverbindung an. Während der Download läuft, führt dich die Einrichtung laut Doku durch diese Schritte:
- E-Mail verbinden (optional). Gmail oder Outlook über Composio, den Dienst, über den Nod Apps anbindet. Du kannst den Schritt überspringen und E-Mail später unter Apps verbinden.
- Über dich (optional). Ein paar Fragen dazu, wobei Nod helfen soll und was du abgeben willst.
- Modell verbinden, falls noch keines eingerichtet ist. Dazu gleich mehr.
- Gesprächsverläufe teilen. Hier entscheidest du, ob Nod Verläufe an n8n schickt; ohne deine Zustimmung bleibt das aus. Der Schritt sagt auch, dass grundlegende Nutzungsdaten standardmäßig an n8n gehen. Abschalten kannst du das unter Settings → Privacy & data.
- E-Mail-Adresse für Neuigkeiten (optional), mit eigener Einwilligung.
Am Ende versucht Nod, Open at login einzuschalten, damit es nach dem Anmelden am Rechner bereitsteht. Nach der ersten Begrüßung im Chat kannst du Benachrichtigungen erlauben. Wie lange Nod danach läuft, hängt vom Rechner ab:
Wenn Aufgaben auch laufen sollen, während dein Laptop zu ist, gehört Nod auf einen eigenen Rechner, der an bleibt. Wie das geht, steht in Nod selbst hosten: der KI-Agent von n8n.
Modell verbinden
Ohne Modell kann Nod nicht denken. Verbindungen legst du in der Einrichtung oder später unter Settings → Models an, mit Add connection. Welches Modell du wählst, entscheidet über Kosten und darüber, wie zuverlässig die Freigabe-Prüfung arbeitet.
ChatGPT Plus oder Pro per Anmeldung
- Wähle OpenAI und dann Sign in with ChatGPT.
- Melde dich im Browser-Tab bei ChatGPT an und erlaube Nod, dein Abo zu nutzen.
- Kehre zu Nod zurück. Lädt die letzte Seite im Browser nicht, kopierst du ihre vollständige Adresse in Callback URL und wählst Complete sign-in.
Die Anmeldung braucht laut Doku ChatGPT Plus oder Pro; bei anderen Plänen schlägt sie fehl. In einem Arbeitsbereich, den deine Firma verwaltet, muss ein Admin Drittanbieter-Apps erst erlauben. In ChatGPT steht Nod danach unter Settings → Usage, wo du die Nutzung sehen, begrenzen oder Nod trennen kannst. Für die Anmeldung nutzt Nod den Port 1455 auf dem Rechner, auf dem Nod läuft.
Claude nur per API-Schlüssel
Ein Claude-Abo kannst du in Nod nicht anmelden. Die Doku schreibt: „Anthropic's authentication conditions also require an API connection for Claude in Nod.“ So verbindest du Claude:
- Erstelle in der Konsole von Anthropic einen API-Schlüssel.
- Wähle in Nod Anthropic, füge den Schlüssel unter API key ein und wähle Connect.
- Gilt der Schlüssel für mehrere Workspaces deiner Organisation, wählst du den passenden Workspace aus.
Du zahlst dann nach Verbrauch an Anthropic, zusätzlich zu einem vorhandenen Abo. Voreingestellt ist laut Doku Claude Opus 5.5 mit hoher Denkstufe.
Andere Anbieter und lokale Modelle
Laut n8n gehen mehr als 30 Anbieter, darunter Google Gemini, OpenRouter, Amazon Bedrock, Google Vertex AI und Azure OpenAI, dazu jeder Server mit OpenAI-kompatibler Schnittstelle. Gemini 3.8 Flash hat laut Doku eine kostenlose Stufe mit Kontingenten; dort gelten andere Bedingungen dafür, was Google mit deinen Daten macht. Lokale Modelle laufen über Ollama, LM Studio, vLLM oder llama.cpp und brauchen laut n8n Tool Calling und 64.000 Token Kontext. Die Modellwahl ist bei Nod auch eine Sicherheitsfrage, denn die Freigabe-Prüfung ist selbst ein Modell. Was das bedeutet, steht im Abschnitt Modelle und Kosten in Nod von n8n: was der KI-Agent kann.
Monatslimit setzen
Mit einem API-Modell zeigt Nod unter Usage (am Mac mit ⌘5), was jede Anfrage gekostet hat. Laut Doku setzt Nod am Ende der Einrichtung ein Monatslimit von 200 US-Dollar. So änderst du es:
- Wähle ein API-Modell und öffne Usage.
- Klick im Satz ganz oben auf dein aktuelles Limit.
- Gib einen Betrag in US-Dollar ein, ab 1 Dollar, und wähle Save.
Du kannst Nod auch im Chat sagen: „Set my monthly limit to $40“. Ist das Limit erreicht, stoppen Zeitpläne, Aufgaben und Hintergrundarbeit, bevor Nod das Modell aufruft. Arbeit, die schon läuft, darf zu Ende laufen, und eine schon freigegebene Aktion wird trotzdem noch ausgeführt. Auf deine Nachrichten antwortet Nod dann nur noch, um das Limit zu ändern. Zusätzlich hält jede Aufgabe laut Doku an, sobald sie seit deiner letzten Nachricht 5 Dollar verbraucht hat, und fragt, ob sie weitermachen soll.
Mit einem ChatGPT-Abo blendet Usage Kosten und Limit aus. Die Abo-Nutzung zählt laut Doku nicht gegen das Monatslimit, die Rückfrage nach 5 Dollar rechnet Nod trotzdem zu API-Preisen. Die Beträge sind Schätzungen von Nod; maßgeblich ist die Rechnung des Anbieters. Was die einzelnen Modellwege im Monat kosten, mit Rechenbeispielen, steht in Nod Kosten: was der KI-Agent von n8n kostet.
Die erste Aufgabe
Nach der Einrichtung öffnet Nod den Chat mit einer kurzen Begrüßung und Ideenkarten: eine Aufgabe für einmal und zwei, die sich wiederholen. Hast du E-Mail verbunden, stützen sich die Karten auf eine kleine Stichprobe deiner Mails, sonst sind es allgemeine Vorschläge. Eine Karte ist keine Erlaubnis: Ihre Worte stammen laut Doku von Nod, nicht von dir, und genehmigen kein Senden oder Löschen.
Du kannst auch ohne verbundene Apps anfangen. Die Doku schlägt vor, drei Lieferantenangebote einzufügen und Nod Preise und Lieferzeiten vergleichen zu lassen, mit Frist und Empfehlung. Für gute erste Aufträge gibt die Doku vier Regeln:
- Sag, wie „fertig“ aussieht, etwa „eine Tabelle mit Preis und Lieferzeit“.
- Nenne Konto oder Website, wenn Nod sich anmelden soll.
- Sag, ob Nod senden oder nur einen Entwurf schreiben soll.
- Wünsch dir Zeitpläne in normalen Worten, etwa „jeden Montag um 9 Uhr“.
Mit dem quadratischen Stop-Knopf neben dem Senden-Knopf hältst du Nod an. Was schon begonnen hat, etwa eine Mail auf dem Weg, macht das laut Doku nicht rückgängig.
Installation aus dem Quellcode
Den Quellcode-Weg nimmst du laut Doku, wenn du den Code von Nod ändern willst. Er läuft auf macOS, Linux und Windows. pnpm start installiert die Abhängigkeiten, baut die Web-App, startet vier Docker-Container (PostgreSQL, Workspace, die Firewall des Workspace und den Browser) und dann den Nod-Server, der nur auf 127.0.0.1 lauscht.
git clone https://github.com/n8n-io/nod.git
cd nod
corepack enable
pnpm start
Der erste Start dauert laut Doku eine Weile. Ist der Server bereit, gibt er einen Link wie http://localhost:4310/#access=… aus. Öffne ihn einmal; danach kennt dein Browser den Zugang, und http://localhost:4310 reicht. Dann folgst du der Einrichtung wie in der App.
Den Schlüssel, mit dem Nod gespeicherte Zugänge verschlüsselt (Vault-Schlüssel), legt Nod auf macOS selbst im Schlüsselbund an, unter Linux in .local/vault/master-key. Unter Windows erzeugst du ihn vorher selbst und trägst ihn als NOD_VAULT_KEY in die Datei .env im Ordner nod ein. Bewahr diesen Schlüssel mit deinem Backup auf, ohne ihn lassen sich gespeicherte Zugänge nicht mehr lesen.
Für das Backup schreibt die Doku selbst: Es gibt noch kein getestetes Verfahren zum Wiederherstellen. Läuft Docker in einer VM wie Colima, gib ihr laut Doku zum Start zwei CPUs und 8 GB Arbeitsspeicher. Von anderen Geräten ist diese Installation nicht erreichbar; dafür brauchst du den Server-Weg mit Token und HTTPS. Die Desktop-App übernimmt übrigens keine Daten aus einer Quellcode-Installation, sie startet mit einem frischen Profil.
Wo deine Daten liegen
Bei einem lokalen Assistenten bleiben Datenbank, Workspace und Browser von Nod auf deinem Rechner:
Anfragen gehen an den Modellanbieter und die Apps, die du wählst. App-Verbindungen laufen laut Doku standardmäßig über einen Dienst, den n8n betreibt, und über Composio. Nutzungsdaten gehen standardmäßig an n8n, Gesprächsverläufe nur, wenn du sie einschaltest. Was genau an wen geht und wie du die Nutzungsdaten abschaltest, steht in Nod Datenschutz: was der KI-Agent weitergibt.
Nod aktualisieren
Auf Mac und Windows sucht Nod laut Doku nach dem Start, alle sechs Stunden und nach dem Aufwachen nach Updates. Von Hand geht es über Check for Updates… im Nod-Menü oder im Infobereich. Ist ein Update geladen, wählst du Restart to update. Läuft gerade eine Aufgabe, fragt Nod vor dem Neustart. Profil, Schlüssel und Daten bleiben erhalten, die Einrichtung startet nicht noch einmal.
Unter Linux sind die Update-Prüfungen aus. Du beendest Nod und installierst das nächste Paket genauso wie das erste; flatpak update holt laut Doku keine neue Nod-Version. Ist deine App mit einem Server verbunden, aktualisiert ein App-Update den Server nicht.
Nod entfernen
App in den Papierkorb oder deinstallieren lässt deine Daten liegen. Eine spätere Installation macht dort weiter. Willst du alles löschen:
- Wähle Remove all data unter Settings → Privacy & data. Kommt Nod nicht durch die Einrichtung, findest du Remove all data… im Nod-Menü.
- Lies die Warnung und bestätige. Nod löscht Profil und eigenen Rechner, startet neu und öffnet die Einrichtung.
- Dann beende Nod und entferne die App: am Mac in den Papierkorb, unter Windows über Einstellungen → Apps, unter Linux mit
flatpak uninstall --delete-data io.n8n.Nod.
Unter Linux bleibt der eigene Rechner in ~/.nod-desktop liegen, wenn du nur das Flatpak entfernst; nimm vorher Remove all data. Am Mac behält Nod laut Doku die heruntergeladene Laufzeit und seinen Eintrag im Schlüsselbund, beide ohne deine Daten. Apps, die du verbunden hast, führen Nod unter Umständen weiter, bis du es dort entfernst.
Häufige Fehler
Alle Fälle stammen aus der Fehlerbehebung der Doku:
Für den Fall mit dem fehlgeschlagenen Update am Mac nennt die Doku diese zwei Befehle. Sie entfernen nur den Update-Job und seinen Cache, nicht dein Profil:
launchctl bootout "gui/$(id -u)/dev.nod.desktop.ShipIt"
rm -rf "$HOME/Library/Caches/dev.nod.desktop.ShipIt"
Meldet der erste Befehl einen Fehler, weil kein Job geladen ist, machst du mit dem zweiten weiter. Wichtig laut Doku: Lösch nie Profil oder eigenen Rechner von Nod, um ein Problem zu beheben, sonst sind Gespräche, Workspace und gespeicherte Schlüssel weg.
Häufige Fragen
Wo lade ich Nod herunter?
Aus den Releases des offiziellen Repositorys n8n-io/nod auf GitHub, verlinkt auch auf nod.n8n.io. Für den Mac gibt es DMG-Dateien für Apple Silicon und Intel, für Windows nod-Setup-x64.exe, für Linux ein in Teile zerlegtes Flatpak.
Brauche ich Docker oder Node.js für Nod?
Für die Desktop-App nicht. Docker, Node.js 24.21 und pnpm brauchst du nur für die Installation aus dem Quellcode, Docker zusätzlich für einen eigenen Server.
Läuft Nod unter Windows 10?
Die Doku nennt Windows 11 x64 als Voraussetzung, und auch dort ist Nod noch eine Vorschau. Für einen lokalen Assistenten brauchst du außerdem WSL 2 und mindestens 20 GB freien Platz.
Kann ich mein Claude-Abo in Nod nutzen?
Nein. Claude läuft in Nod nur mit einem API-Schlüssel von Anthropic, laut Doku wegen der Bedingungen von Anthropic. Ein ChatGPT-Plus- oder Pro-Abo kannst du dagegen direkt anmelden.
Wie lange dauert die Installation?
n8n gibt für die Einrichtung mit App, Modell und Apps etwa zehn Minuten an. Dazu kommt der Download von rund 1,8 GB auf dem Mac bzw. 2,1 GB unter Windows.
Kann ich Nod mit allen Daten wieder entfernen?
Ja. Erst Remove all data unter Settings → Privacy & data, dann die App entfernen. Nur die App zu löschen lässt deine Daten liegen.
Wie du weitermachst
Installiere Nod zuerst ohne verbundene Apps und gib ihm eine Aufgabe mit Material, das du ihm selbst in den Chat legst. So siehst du, wie Nod fragt und was eine Aufgabe unter Usage kostet, bevor es an dein Postfach darf. Setz das Monatslimit auf einen Betrag, den du bewusst ausgeben willst. Soll Nod rund um die Uhr laufen, ist der nächste Schritt ein eigener Server. Die Anleitung dazu steht in Nod selbst hosten: der KI-Agent von n8n. Suchst du eigentlich die Workflow-Software n8n, findest du sie in meiner Anleitung zu n8n mit Docker und Kubernetes. Wie ich KI-Mitarbeiter mit klaren Rechten und Freigaben aufbaue, zeige ich in meiner deutschsprachigen Community Claude Practitioners.
