Deployment Lokal n8n

Deploy n8n secara lokal di Linux/macOS, instal community node CometAPI, dan konfigurasikan kredensial API untuk menjalankan workflow otomatis di mesin Anda.

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 koneksi ke registry npm publik
• Node.js 18.x atau 20.x LTS (lihat Langkah 1)
• Akun CometAPI dengan API key aktif — dapatkan di sini

1. Dapatkan API key CometAPI Anda

   Masuk ke konsol CometAPI. Klik Add API Key lalu salin key sk-xxxxx Anda.

   

   
2. Instal Node.js melalui nvm

   n8n 1.x memerlukan Node.js 18.x atau 20.x. Pendekatan yang direkomendasikan adalah nvm:

   # 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
   

   Jika nanti Anda melihat n8n: command not found, restart terminal atau pastikan direktori bin global npm yang dikelola nvm ada di PATH Anda.

3. Instal dan jalankan n8n

   npm install -g n8n
   n8n -v       # verify the installed version
   n8n start    # runs on http://localhost:5678/
   

   Jika port 5678 sudah digunakan:

   export N8N_PORT=5679
   n8n start
   

   Untuk tetap menjalankan n8n setelah terminal ditutup:

   npm install -g pm2
   pm2 start "n8n" --name n8n
   pm2 save
   pm2 status
   

   

   
4. Buat akun owner Anda

   Buka http://localhost:5678/ di browser Anda. Saat pertama kali dijalankan, wizard penyiapan akan meminta Anda membuat akun Owner (email + kata sandi). Selesaikan proses ini lalu masuk.

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

   

   

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

6. Buat workflow dan konfigurasikan kredensial

   1. Klik + New di bagian atas untuk membuat workflow.
   2. Klik + pada canvas lalu cari CometAPI untuk menambahkan node.

   

   

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

   

   5. Konfigurasikan node:

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

   6. Klik Execute step untuk menjalankan node. Panel Output akan menampilkan respons JSON.

   

Pemecahan masalah

• Error node-gyp atau 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) — atur N8N_PORT=5679 (atau port kosong lainnya) 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 tersebut 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.