> ## 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.
# CometAPI ile n8n'i yerel olarak çalıştırın
> Yerel dağıtım ayarlarını, kimlik bilgilerini ve model erişimini yapılandırarak n8n'i CometAPI ile yerel olarak çalıştırmak için bu kılavuzu kullanın.
n8n'i kendi makinenize dağıtın ve otomatik AI iş akışlarını yerel olarak çalıştırmak için topluluk düğümü aracılığıyla CometAPI'ye bağlayın.
## Ön koş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 anahtarına sahip bir CometAPI hesabı — [buradan alın](https://www.cometapi.com/console/token)
[CometAPI konsolunda](https://www.cometapi.com/console/token) oturum açın. **Add API Key** seçeneğine tıklayın ve CometAPI API anahtarınızı kopyalayın.
n8n 1.x, Node.js 18.x veya 20.x gerektirir. Önerilen yaklaşım [nvm](https://github.com/nvm-sh/nvm)'dir:
```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
```
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.
```bash theme={null}
npm install -g n8n
n8n -v # verify the installed version
n8n start # runs on http://localhost:5678/
```
5678 portu zaten kullanımdaysa:
```bash theme={null}
export N8N_PORT=5679
n8n start
```
Terminali kapattıktan sonra da n8n'in çalışmaya devam etmesi için:
```bash theme={null}
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
```
Tarayıcınızda [http://localhost:5678/](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.
1. **Settings**'e gidin (sol alt) → **Community nodes**
2. **Install a community node** seçeneğine tıklayın
3. Paket adını girin: `@cometapi-dev/n8n-nodes-cometapi`
4. Risk onayı kutusunu işaretleyin ve **Install** seçeneğine 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.
1. Bir workflow oluşturmak için üstteki **+ New** seçeneğine tıklayın.
2. Tuval üzerinde **+** seçeneğine tıklayın ve node'u eklemek için **CometAPI** aratı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çeneğini seçin. CometAPI API anahtarınızı **CometAPI Key** alanına yapıştırın ve **Save** seçeneğine 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 güncel model ID değerini 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** seçeneğine tıklayın. **Output** paneli JSON yanıtını gösterir.
* **`node-gyp` veya native build hataları** — build araçlarını yükleyin: `sudo apt install build-essential python3` (Debian/Ubuntu) veya Xcode Command Line Tools (macOS).
* **npm izin hataları (EACCES)** — kullanıcı düzeyinde bir 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 bir boş 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 anahtarınızı 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** değerlerini ayarlayın.
* **Terminal kapandığında n8n duruyor** — pm2 kullanın: `pm2 start "n8n" --name n8n && pm2 save`.