> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n lokal mit CometAPI ausführen

> Verwenden Sie diese Anleitung, um n8n lokal mit CometAPI auszuführen, indem Sie lokale Deployment-Einstellungen, Anmeldedaten und den Modellzugriff konfigurieren.

Stellen Sie n8n auf Ihrem eigenen Rechner bereit und verbinden Sie es über den Community-Node mit CometAPI, um automatisierte KI-Workflows lokal auszuführen.

## Voraussetzungen

* Linux (Ubuntu/Debian/CentOS usw.) oder macOS
* 2 GB+ RAM, 10 GB+ freier Speicherplatz
* Shell-Zugriff mit Zugriff auf die öffentliche npm-Registry
* Node.js 18.x oder 20.x LTS (siehe Schritt 1)
* Ein CometAPI-Konto mit einem aktiven API key — [hier erhalten](https://www.cometapi.com/console/token)

<Steps>
  <Step title="Holen Sie sich Ihren CometAPI API key">
    Melden Sie sich in der [CometAPI-Konsole](https://www.cometapi.com/console/token) an. Klicken Sie auf **Add API Key** und kopieren Sie Ihren CometAPI API key.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="CometAPI-Dashboard mit der Schaltfläche „Add API Key“" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="CometAPI-API-key-Details mit Base-URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Installieren Sie Node.js über nvm">
    n8n 1.x benötigt Node.js 18.x oder 20.x. Der empfohlene Ansatz ist [nvm](https://github.com/nvm-sh/nvm):

    ```bash theme={null}
    # Install nvm
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    # Reload your shell profile
    source ~/.bashrc   # or ~/.zshrc on macOS

    # Install and activate the LTS version
    nvm install --lts
    nvm use --lts

    # Verify
    node -v
    npm -v
    ```

    <Note>
      Wenn Sie später `n8n: command not found` sehen, starten Sie das Terminal neu oder stellen Sie sicher, dass sich das von nvm verwaltete globale npm-bin-Verzeichnis in Ihrem `PATH` befindet.
    </Note>
  </Step>

  <Step title="Installieren und starten Sie n8n">
    ```bash theme={null}
    npm install -g n8n
    n8n -v       # verify the installed version
    n8n start    # runs on http://localhost:5678/
    ```

    Falls Port 5678 bereits verwendet wird:

    ```bash theme={null}
    export N8N_PORT=5679
    n8n start
    ```

    So bleibt n8n auch nach dem Schließen des Terminals weiter aktiv:

    ```bash theme={null}
    npm install -g pm2
    pm2 start "n8n" --name n8n
    pm2 save
    pm2 status
    ```

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360463.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=80fe6068a8af4ec3b3503ff41d378a17" alt="Terminal zeigt erfolgreich gestartetes n8n" width="715" height="451" data-path="images/integrations/810968_360463.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360464.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=77cadfd218dbe0fef19fe701550ea363" alt="n8n-Startprotokolle im Terminal" width="759" height="460" data-path="images/integrations/810968_360464.png" />
    </Frame>
  </Step>

  <Step title="Erstellen Sie Ihr Owner-Konto">
    Öffnen Sie [http://localhost:5678/](http://localhost:5678/) in Ihrem Browser. Beim ersten Start fordert Sie der Einrichtungsassistent auf, ein **Owner**-Konto (E-Mail + Passwort) zu erstellen. Schließen Sie dies ab und melden Sie sich an.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360465.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=8fdd100138f2bf01bbf834d9db1ea29e" alt="n8n-Einrichtungsassistent beim ersten Start, der nach Owner-Kontodetails fragt" width="1249" height="970" data-path="images/integrations/810968_360465.png" />
    </Frame>
  </Step>

  <Step title="Installieren Sie den CometAPI-Community-Node">
    1. Gehen Sie zu **Settings** (unten links) → **Community nodes**
    2. Klicken Sie auf **Install a community node**
    3. Geben Sie den Paketnamen ein: `@cometapi-dev/n8n-nodes-cometapi`
    4. Aktivieren Sie das Kontrollkästchen zur Risikobestätigung und klicken Sie auf **Install**

    Nach der Installation können Sie im Node-Panel nach **CometAPI** suchen.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360467.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=1c107922e16332157d278bf834b3e32a" alt="n8n-Settings-Panel mit dem Abschnitt „Community nodes“" width="1265" height="975" data-path="images/integrations/810968_360467.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360468.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=98c05d77cb6adf333052b4d5014fc506" alt="Installationsdialog mit eingegebenem CometAPI-Paketnamen" width="1261" height="965" data-path="images/integrations/810968_360468.png" />
    </Frame>

    <Note>
      Falls der Abschnitt „Community Nodes“ fehlt: Stellen Sie sicher, dass Sie mit dem **Owner**-Konto angemeldet sind, und prüfen Sie unter **Settings → Security**, ob die Installation von Community-Nodes aktiviert ist.
    </Note>
  </Step>

  <Step title="Erstellen Sie einen Workflow und konfigurieren Sie Credentials">
    1. Klicken Sie oben auf **+ New**, um einen Workflow zu erstellen.
    2. Klicken Sie auf dem Canvas auf **+** und suchen Sie nach **CometAPI**, um den Node hinzuzufügen.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360469.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=b47e1304ec3165720dd3ef37e1429485" alt="n8n-Workflow-Canvas mit geöffneter CometAPI-Node-Suche" width="1235" height="899" data-path="images/integrations/810968_360469.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360472.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=b765a2d8024f4c5d36305916c440d02f" alt="CometAPI-Node zum n8n-Canvas hinzugefügt" width="1724" height="854" data-path="images/integrations/810968_360472.png" />
    </Frame>

    3. Fügen Sie einen **Manual Trigger**-Node hinzu und verbinden Sie ihn mit dem CometAPI-Node.
    4. Wählen Sie im CometAPI-Node unter **Credential to connect with** die Option **Create new**. Fügen Sie Ihren CometAPI API key in **CometAPI Key** ein und klicken Sie auf **Save**. Die Base-URL ist standardmäßig `https://api.cometapi.com` und muss normalerweise nicht geändert werden.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360474.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=deee1c999cbfb2c432daaa53904d6b38" alt="CometAPI-Credential-Dialog mit eingegebenem API key" width="1906" height="608" data-path="images/integrations/810968_360474.png" />
    </Frame>

    5. Konfigurieren Sie den Node:

    * **Model**: Geben Sie die aktuelle model ID ein, die Sie verwenden möchten
    * **Messages**: Setzen Sie Role auf `user`, Content auf Ihren Test-Prompt (z. B. `Hello`)
    * Optional: Fügen Sie eine `system`-Nachricht hinzu, setzen Sie **Max Tokens**, **Temperature** usw.

    6. Klicken Sie auf **Execute step**, um den Node auszuführen. Im Bereich **Output** wird die JSON-Antwort angezeigt.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360471.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=6953b97533f02e4f50cb1f0490ff057d" alt="n8n-Output-Panel mit einer erfolgreichen CometAPI-JSON-Antwort" width="2092" height="1762" data-path="images/integrations/810968_360471.png" />
    </Frame>
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Fehlerbehebung">
    * **`node-gyp` oder native Build-Fehler** — installieren Sie Build-Tools: `sudo apt install build-essential python3` (Debian/Ubuntu) oder Xcode Command Line Tools (macOS).
    * **npm-Berechtigungsfehler (EACCES)** — verwenden Sie nvm für eine Node.js-Installation auf Benutzerebene; `sudo` ist nicht erforderlich.
    * **Port-Konflikt (`localhost:5678` nicht verfügbar)** — setzen Sie `N8N_PORT=5679` (oder einen anderen freien Port), bevor Sie `n8n start` ausführen.
    * **Abschnitt „Community Nodes“ fehlt** — melden Sie sich mit dem **Owner**-Konto an und prüfen Sie **Settings → Security**.
    * **npm install schlägt in Unternehmensnetzwerken fehl** — konfigurieren Sie einen Proxy: `npm config set proxy http://user:pass@host:port`
    * **CometAPI-Node gibt 401/403 zurück** — prüfen Sie Ihren API key und ob das Modell in Ihrem CometAPI-Plan verfügbar ist.
    * **Leere Antworten oder Token-Limit-Fehler** — erhöhen Sie **Max Tokens**; passen Sie **Temperature** und **Top P** nach Bedarf an.
    * **n8n stoppt, wenn das Terminal geschlossen wird** — verwenden Sie pm2: `pm2 start "n8n" --name n8n && pm2 save`.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#howto",
        "name": "n8n lokal mit CometAPI ausführen",
        "description": "Verwenden Sie diese Anleitung, um n8n lokal mit CometAPI auszuführen, indem Sie lokale Deployment-Einstellungen, Credentials und Modellzugriff konfigurieren.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-1",
            "position": 1,
            "name": "Holen Sie sich Ihren CometAPI API key",
            "text": "Erstellen oder öffnen Sie Ihr CometAPI-Konto und kopieren Sie dann einen aktiven API key aus dem Dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-2",
            "position": 2,
            "name": "Installieren Sie Node.js über nvm",
            "text": "Schließen Sie den Schritt „Installieren Sie Node.js über nvm“ in der Anleitung „n8n lokal mit CometAPI ausführen“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-3",
            "position": 3,
            "name": "Installieren und starten Sie n8n",
            "text": "Schließen Sie den Schritt „Installieren und starten Sie n8n“ in der Anleitung „n8n lokal mit CometAPI ausführen“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-4",
            "position": 4,
            "name": "Erstellen Sie Ihr Owner-Konto",
            "text": "Schließen Sie den Schritt „Erstellen Sie Ihr Owner-Konto“ in der Anleitung „n8n lokal mit CometAPI ausführen“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-5",
            "position": 5,
            "name": "Installieren Sie den CometAPI-Community-Node",
            "text": "Schließen Sie den Schritt „Installieren Sie den CometAPI-Community-Node“ in der Anleitung „n8n lokal mit CometAPI ausführen“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-6",
            "position": 6,
            "name": "Erstellen Sie einen Workflow und konfigurieren Sie Credentials",
            "text": "Schließen Sie den Schritt „Erstellen Sie einen Workflow und konfigurieren Sie Credentials“ in der Anleitung „n8n lokal mit CometAPI ausführen“ ab."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-Dokumentation",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrationen",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "n8n lokal mit CometAPI ausführen",
            "item": "https://apidoc.cometapi.com/integrations/n8n-local-deployment"
          }
        ]
      }
    ]
    }
    `}
</script>
