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

# Menjalankan n8n secara lokal dengan CometAPI

> Gunakan panduan ini untuk menjalankan n8n secara lokal dengan CometAPI dengan mengonfigurasi pengaturan deployment lokal, kredensial, dan akses model.

Deploy n8n di mesin Anda sendiri dan hubungkan ke CometAPI melalui community node untuk menjalankan workflow AI otomatis secara lokal.

## Prasyarat

* Linux (Ubuntu/Debian/CentOS, dll.) atau macOS
* RAM 2 GB+, ruang disk kosong 10 GB+
* Akses shell dengan jangkauan ke registry npm publik
* Node.js 18.x atau 20.x LTS (lihat Langkah 1)
* Akun CometAPI dengan API key aktif — [dapatkan di sini](https://www.cometapi.com/console/token)

<Steps>
  <Step title="Dapatkan API key CometAPI Anda">
    Masuk ke [konsol CometAPI](https://www.cometapi.com/console/token). Klik **Add API Key** lalu salin API key CometAPI Anda.

    <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="Dasbor CometAPI yang menampilkan tombol 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="Detail API key CometAPI dengan base URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Instal Node.js melalui nvm">
    n8n 1.x memerlukan Node.js 18.x atau 20.x. Pendekatan yang direkomendasikan adalah [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>
      Jika nanti Anda melihat `n8n: command not found`, mulai ulang terminal atau pastikan direktori bin global npm yang dikelola nvm ada di `PATH` Anda.
    </Note>
  </Step>

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

    Jika port 5678 sudah digunakan:

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

    Agar n8n tetap berjalan setelah terminal ditutup:

    ```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 yang menunjukkan n8n berhasil dijalankan" 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="Log startup n8n di terminal" width="759" height="460" data-path="images/integrations/810968_360464.png" />
    </Frame>
  </Step>

  <Step title="Buat akun owner Anda">
    Buka [http://localhost:5678/](http://localhost:5678/) di browser Anda. Pada pertama kali dijalankan, wizard penyiapan akan meminta Anda membuat akun **Owner** (email + kata sandi). Selesaikan langkah ini lalu masuk.

    <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="Wizard penyiapan pertama n8n yang meminta detail akun Owner" width="1249" height="970" data-path="images/integrations/810968_360465.png" />
    </Frame>
  </Step>

  <Step title="Instal community node CometAPI">
    1. Buka **Settings** (pojok kiri bawah) → **Community nodes**
    2. Klik **Install a community node**
    3. Masukkan nama package: `@cometapi-dev/n8n-nodes-cometapi`
    4. Centang kotak pengakuan risiko lalu klik **Install**

    Setelah instalasi, Anda dapat mencari **CometAPI** di panel node.

    <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 n8n yang menampilkan bagian 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="Dialog instalasi dengan nama package CometAPI yang sudah dimasukkan" width="1261" height="965" data-path="images/integrations/810968_360468.png" />
    </Frame>

    <Note>
      Jika bagian Community Nodes tidak ada: pastikan Anda masuk sebagai akun **Owner**, lalu periksa **Settings → Security** untuk memastikan instalasi community node diaktifkan.
    </Note>
  </Step>

  <Step title="Buat workflow dan konfigurasikan kredensial">
    1. Klik **+ New** di bagian atas untuk membuat workflow.
    2. Klik **+** pada canvas lalu cari **CometAPI** untuk menambahkan node.

    <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="Canvas workflow n8n dengan pencarian node CometAPI terbuka" 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="Node CometAPI ditambahkan ke canvas n8n" width="1724" height="854" data-path="images/integrations/810968_360472.png" />
    </Frame>

    3. Tambahkan node **Manual Trigger** dan hubungkan ke node CometAPI.
    4. Di node CometAPI, pada **Credential to connect with**, pilih **Create new**. Tempelkan API key CometAPI Anda ke **CometAPI Key** lalu klik **Save**. Base URL default-nya adalah `https://api.cometapi.com` dan biasanya tidak perlu diubah.

    <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="Dialog kredensial CometAPI dengan API key yang sudah dimasukkan" width="1906" height="608" data-path="images/integrations/810968_360474.png" />
    </Frame>

    5. Konfigurasikan node:

    * **Model**: masukkan model ID saat ini yang ingin Anda gunakan
    * **Messages**: atur Role ke `user`, Content ke prompt uji Anda (misalnya `Hello`)
    * Opsional: tambahkan pesan `system`, atur **Max Tokens**, **Temperature**, dll.

    6. Klik **Execute step** untuk menjalankan node. Panel **Output** menampilkan respons 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 n8n yang menampilkan respons JSON CometAPI yang berhasil" width="2092" height="1762" data-path="images/integrations/810968_360471.png" />
    </Frame>
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Pemecahan masalah">
    * **`node-gyp` atau error build native** — instal build tools: `sudo apt install build-essential python3` (Debian/Ubuntu) atau Xcode Command Line Tools (macOS).
    * **error izin npm (EACCES)** — gunakan nvm untuk instalasi Node.js di level pengguna; tidak perlu `sudo`.
    * **Konflik port (`localhost:5678` tidak tersedia)** — setel `N8N_PORT=5679` (atau port kosong lain) sebelum menjalankan `n8n start`.
    * **Bagian Community Nodes tidak ada** — masuk sebagai akun **Owner** dan periksa **Settings → Security**.
    * **npm install gagal di jaringan perusahaan** — konfigurasikan proxy: `npm config set proxy http://user:pass@host:port`
    * **Node CometAPI mengembalikan 401/403** — verifikasi API key Anda dan pastikan model dapat diakses dalam paket CometAPI Anda.
    * **Respons kosong atau error batas token** — tingkatkan **Max Tokens**; sesuaikan **Temperature** dan **Top P** sesuai kebutuhan.
    * **n8n berhenti saat terminal ditutup** — gunakan 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": "Jalankan n8n secara lokal dengan CometAPI",
        "description": "Gunakan panduan ini untuk menjalankan n8n secara lokal dengan CometAPI dengan mengonfigurasi pengaturan deployment lokal, kredensial, dan akses model.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-1",
            "position": 1,
            "name": "Dapatkan API key CometAPI Anda",
            "text": "Buat atau buka akun CometAPI Anda, lalu salin API key aktif dari dasbor."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-2",
            "position": 2,
            "name": "Instal Node.js melalui nvm",
            "text": "Selesaikan langkah Instal Node.js melalui nvm di panduan Jalankan n8n secara lokal dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-3",
            "position": 3,
            "name": "Instal dan jalankan n8n",
            "text": "Selesaikan langkah Instal dan jalankan n8n di panduan Jalankan n8n secara lokal dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-4",
            "position": 4,
            "name": "Buat akun owner Anda",
            "text": "Selesaikan langkah Buat akun owner Anda di panduan Jalankan n8n secara lokal dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-5",
            "position": 5,
            "name": "Instal community node CometAPI",
            "text": "Selesaikan langkah Instal community node CometAPI di panduan Jalankan n8n secara lokal dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/n8n-local-deployment#step-6",
            "position": 6,
            "name": "Buat workflow dan konfigurasikan kredensial",
            "text": "Selesaikan langkah Buat workflow dan konfigurasikan kredensial di panduan Jalankan n8n secara lokal dengan CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentasi CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrations",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Jalankan n8n secara lokal dengan CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/n8n-local-deployment"
          }
        ]
      }
    ]
    }
    `}
</script>
