> ## 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.

# Uruchom n8n lokalnie z CometAPI

> Skorzystaj z tego przewodnika, aby uruchomić n8n lokalnie z CometAPI, konfigurując ustawienia wdrożenia lokalnego, poświadczenia i dostęp do modeli.

Wdróż n8n na własnym komputerze i połącz je z CometAPI za pomocą węzła społeczności, aby lokalnie uruchamiać zautomatyzowane przepływy pracy AI.

## Wymagania wstępne

* Linux (Ubuntu/Debian/CentOS itp.) lub macOS
* 2 GB+ RAM, 10 GB+ wolnego miejsca na dysku
* Dostęp do powłoki z połączeniem do publicznego rejestru npm
* Node.js 18.x lub 20.x LTS (zobacz krok 1)
* Konto CometAPI z aktywnym kluczem API — [pobierz go tutaj](https://www.cometapi.com/console/token)

<Steps>
  <Step title="Pobierz swój klucz API CometAPI">
    Zaloguj się do [konsoli CometAPI](https://www.cometapi.com/console/token). Kliknij **Add API Key** i skopiuj swój klucz API CometAPI.

    <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="Pulpit CometAPI pokazujący przycisk 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="Szczegóły klucza API CometAPI z podstawowym adresem URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Zainstaluj Node.js przez nvm">
    n8n 1.x wymaga Node.js 18.x lub 20.x. Zalecanym podejściem jest [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>
      Jeśli później zobaczysz `n8n: command not found`, uruchom ponownie terminal lub upewnij się, że katalog globalnych plików binarnych npm zarządzany przez nvm znajduje się w twoim `PATH`.
    </Note>
  </Step>

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

    Jeśli port 5678 jest już używany:

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

    Aby n8n działał po zamknięciu terminala:

    ```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 pokazujący pomyślne uruchomienie 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="Logi uruchamiania n8n w terminalu" width="759" height="460" data-path="images/integrations/810968_360464.png" />
    </Frame>
  </Step>

  <Step title="Utwórz swoje konto właściciela">
    Otwórz [http://localhost:5678/](http://localhost:5678/) w przeglądarce. Przy pierwszym uruchomieniu kreator konfiguracji poprosi o utworzenie konta **Owner** (e-mail + hasło). Ukończ ten krok i zaloguj się.

    <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="Kreator pierwszego uruchomienia n8n proszący o dane konta Owner" width="1249" height="970" data-path="images/integrations/810968_360465.png" />
    </Frame>
  </Step>

  <Step title="Zainstaluj węzeł społeczności CometAPI">
    1. Przejdź do **Settings** (lewy dolny róg) → **Community nodes**
    2. Kliknij **Install a community node**
    3. Wprowadź nazwę pakietu: `@cometapi-dev/n8n-nodes-cometapi`
    4. Zaznacz pole potwierdzenia ryzyka i kliknij **Install**

    Po instalacji możesz wyszukać **CometAPI** w panelu węzłów.

    <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="Panel Settings w n8n pokazujący sekcję 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="Okno instalacji z wprowadzoną nazwą pakietu CometAPI" width="1261" height="965" data-path="images/integrations/810968_360468.png" />
    </Frame>

    <Note>
      Jeśli sekcja Community Nodes jest niewidoczna: upewnij się, że jesteś zalogowany jako konto **Owner**, i sprawdź w **Settings → Security**, czy instalacja węzłów społeczności jest włączona.
    </Note>
  </Step>

  <Step title="Utwórz workflow i skonfiguruj poświadczenia">
    1. Kliknij **+ New** u góry, aby utworzyć workflow.
    2. Kliknij **+** na obszarze roboczym i wyszukaj **CometAPI**, aby dodać węzeł.

    <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="Obszar workflow w n8n z otwartym wyszukiwaniem węzła CometAPI" 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="Węzeł CometAPI dodany do obszaru roboczego n8n" width="1724" height="854" data-path="images/integrations/810968_360472.png" />
    </Frame>

    3. Dodaj węzeł **Manual Trigger** i połącz go z węzłem CometAPI.
    4. W węźle CometAPI, w sekcji **Credential to connect with**, wybierz **Create new**. Wklej swój klucz API CometAPI do pola **CometAPI Key** i kliknij **Save**. Pole Base URL domyślnie ma wartość `https://api.cometapi.com` i zazwyczaj nie wymaga zmiany.

    <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="Okno poświadczeń CometAPI z wprowadzonym kluczem API" width="1906" height="608" data-path="images/integrations/810968_360474.png" />
    </Frame>

    5. Skonfiguruj węzeł:

    * **Model**: wprowadź bieżący model ID, którego chcesz użyć
    * **Messages**: ustaw Role na `user`, a Content na testowy prompt (np. `Hello`)
    * Opcjonalnie: dodaj wiadomość `system`, ustaw **Max Tokens**, **Temperature** itd.

    6. Kliknij **Execute step**, aby uruchomić węzeł. Panel **Output** wyświetli odpowiedź JSON.

    <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="Panel output w n8n pokazujący poprawną odpowiedź JSON z CometAPI" width="2092" height="1762" data-path="images/integrations/810968_360471.png" />
    </Frame>
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Rozwiązywanie problemów">
    * **`node-gyp` lub błędy natywnej kompilacji** — zainstaluj narzędzia build tools: `sudo apt install build-essential python3` (Debian/Ubuntu) lub Xcode Command Line Tools (macOS).
    * **Błędy uprawnień npm (EACCES)** — użyj nvm do instalacji Node.js na poziomie użytkownika; `sudo` nie jest potrzebne.
    * **Konflikt portów (`localhost:5678` niedostępny)** — ustaw `N8N_PORT=5679` (lub inny wolny port) przed uruchomieniem `n8n start`.
    * **Brak sekcji Community Nodes** — zaloguj się jako konto **Owner** i sprawdź **Settings → Security**.
    * **`npm install` kończy się niepowodzeniem w sieciach firmowych** — skonfiguruj proxy: `npm config set proxy http://user:pass@host:port`
    * **Węzeł CometAPI zwraca 401/403** — sprawdź swój klucz API i upewnij się, że model jest dostępny w twoim planie CometAPI.
    * **Puste odpowiedzi lub błędy limitu tokenów** — zwiększ **Max Tokens**; dostosuj **Temperature** i **Top P** w razie potrzeby.
    * **n8n zatrzymuje się po zamknięciu terminala** — użyj 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": "Uruchom n8n lokalnie z CometAPI",
        "description": "Skorzystaj z tego przewodnika, aby uruchomić n8n lokalnie z CometAPI, konfigurując ustawienia wdrożenia lokalnego, poświadczenia i dostęp do modelu.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-1",
            "position": 1,
            "name": "Pobierz swój klucz API CometAPI",
            "text": "Utwórz lub otwórz swoje konto CometAPI, a następnie skopiuj aktywny klucz API z pulpitu."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-2",
            "position": 2,
            "name": "Zainstaluj Node.js przez nvm",
            "text": "Wykonaj krok Zainstaluj Node.js przez nvm w przewodniku Uruchom n8n lokalnie z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-3",
            "position": 3,
            "name": "Zainstaluj i uruchom n8n",
            "text": "Wykonaj krok Zainstaluj i uruchom n8n w przewodniku Uruchom n8n lokalnie z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-4",
            "position": 4,
            "name": "Utwórz swoje konto właściciela",
            "text": "Wykonaj krok Utwórz swoje konto właściciela w przewodniku Uruchom n8n lokalnie z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-5",
            "position": 5,
            "name": "Zainstaluj węzeł społeczności CometAPI",
            "text": "Wykonaj krok Zainstaluj węzeł społeczności CometAPI w przewodniku Uruchom n8n lokalnie z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-6",
            "position": 6,
            "name": "Utwórz workflow i skonfiguruj poświadczenia",
            "text": "Wykonaj krok Utwórz workflow i skonfiguruj poświadczenia w przewodniku Uruchom n8n lokalnie z CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentacja CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integracje",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Uruchom n8n lokalnie z CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/n8n-local-deployment"
          }
        ]
      }
    ]
    }
    `}
</script>
