n8n Yerel Dağıtımı

Linux/macOS üzerinde n8n’i yerel olarak dağıtın, CometAPI topluluk düğümünü yükleyin ve makinenizde otomatik iş akışlarını çalıştırmak için API kimlik bilgilerini yapılandırın.

n8n’i kendi makinenize dağıtın ve yerel olarak otomatik AI iş akışlarını çalıştırmak için topluluk düğümü aracılığıyla CometAPI’ye bağlayın.

​

Önkoşullar

• Linux (Ubuntu/Debian/CentOS vb.) veya macOS
• 2 GB+ RAM, 10 GB+ boş disk alanı
• Genel npm registry’sine erişebilen shell erişimi
• Node.js 18.x veya 20.x LTS (bkz. Adım 1)
• Etkin bir API key’e sahip bir CometAPI hesabı — buradan alın

1. CometAPI API key’inizi alın

   CometAPI console’a giriş yapın. Add API Key’e tıklayın ve sk-xxxxx anahtarınızı kopyalayın.

   

   
2. nvm ile Node.js kurun

   n8n 1.x, Node.js 18.x veya 20.x gerektirir. Önerilen yaklaşım nvm’dir:

   # 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
   

   Daha sonra n8n: command not found görürseniz terminali yeniden başlatın veya nvm tarafından yönetilen npm global bin dizininin PATH içinde olduğundan emin olun.

3. n8n’i kurun ve başlatın

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

   5678 portu zaten kullanımdaysa:

   export N8N_PORT=5679
   n8n start
   

   Terminali kapattıktan sonra da n8n’in çalışmaya devam etmesi için:

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

   

   
4. Owner hesabınızı oluşturun

   Tarayıcınızda http://localhost:5678/ adresini açın. İlk çalıştırmada kurulum sihirbazı sizden bir Owner hesabı (e-posta + parola) oluşturmanızı ister. Bunu tamamlayın ve oturum açın.

   
5. CometAPI community node’unu kurun

   1. Settings’e gidin (sol alt) → Community nodes
   2. Install a community node’a tıklayın
   3. Paket adını girin: @cometapi-dev/n8n-nodes-cometapi
   4. Risk onay kutusunu işaretleyin ve Install’a tıklayın

   Kurulumdan sonra node panelinde CometAPI araması yapabilirsiniz.

   

   

   Community Nodes bölümü görünmüyorsa: Owner hesabıyla oturum açtığınızdan emin olun ve community node kurulumunun etkin olduğunu doğrulamak için Settings → Security bölümünü kontrol edin.

6. Bir workflow oluşturun ve credentials yapılandırın

   1. Bir workflow oluşturmak için üstteki + New’e tıklayın.
   2. Canvas üzerinde +’a tıklayın ve node’u eklemek için CometAPI arayın.

   

   

   3. Bir Manual Trigger node’u ekleyin ve bunu CometAPI node’una bağlayın.
   4. CometAPI node’unda, Credential to connect with altında Create new’ü seçin. sk-xxxxx anahtarınızı CometAPI Key alanına yapıştırın ve Save’e tıklayın. Base URL varsayılan olarak https://api.cometapi.com olur ve genellikle değiştirilmesi gerekmez.

   

   5. Node’u yapılandırın:

   • Model: kullanmak istediğiniz mevcut model ID’sini girin
   • Messages: Role değerini user, Content değerini test prompt’unuz olarak ayarlayın (ör. Hello)
   • İsteğe bağlı: bir system mesajı ekleyin, Max Tokens, Temperature vb. ayarlayın.

   6. Node’u çalıştırmak için Execute step’e tıklayın. Output paneli JSON yanıtını gösterir.

   

Sorun giderme

• node-gyp veya native build hataları — build araçlarını kurun: sudo apt install build-essential python3 (Debian/Ubuntu) veya Xcode Command Line Tools (macOS).
• npm izin hataları (EACCES) — kullanıcı düzeyinde Node.js kurulumu için nvm kullanın; sudo gerekmez.
• Port çakışması (localhost:5678 kullanılamıyor) — n8n start çalıştırmadan önce N8N_PORT=5679 (veya başka boş bir port) ayarlayın.
• Community Nodes bölümü eksik — Owner hesabıyla oturum açın ve Settings → Security bölümünü kontrol edin.
• Kurumsal ağlarda npm install başarısız oluyor — bir proxy yapılandırın: npm config set proxy http://user:pass@host:port
• CometAPI node’u 401/403 döndürüyor — API key’inizi ve modelin CometAPI planınızda erişilebilir olduğunu doğrulayın.
• Boş yanıtlar veya token limit hataları — Max Tokens değerini artırın; gerektiğinde Temperature ve Top P ayarlayın.
• Terminal kapanınca n8n duruyor — pm2 kullanın: pm2 start "n8n" --name n8n && pm2 save.