Hızlı Özet: n8n'i yerel olarak çalıştırmak için npm (Node.js 20.19-24.x) veya Docker gerekir. En hızlı yöntem, kurulum yapmadan anında test etmek için npx n8n kullanırken, Docker daha iyi izolasyon ve üretim hazırlığı sağlar. Her iki yöntem de yinelenen bulut maliyetleri olmadan n8n'in iş akışı otomasyon yeteneklerine tam erişim sağlar.
n8n'i yerel bir makineye kurmak, yinelenen abonelik ücretlerini ortadan kaldırırken iş akışı otomasyonu üzerinde tam kontrol sağlar. Resmi n8n belgelerine göre, platform npm kurulumları için Node.js sürümü 20.19 ile 24.x arasında veya kapsüllenmiş dağıtımlar için Docker gerektirir.
Yerel barındırma ve bulut hizmetleri arasındaki karar hem bütçeyi hem de esnekliği etkiler. Topluluk tartışmalarına göre, yerel kurulumlar sınırsız iş akışlarını yönetirken, bulut planları yürütmeye dayalı fiyatlandırma içerir (bazı kullanıcı raporlarına göre 2.500 yürütme için ayda 24 dolardan başlayan fiyatlarla).
Yerel Kurulum Ön Koşulları
n8n'i yerel olarak kurmadan önce, seçilen yönteme bağlı olarak sistemin belirli yazılımlara ihtiyacı vardır.
npm kurulumu için gerekli Node.js sürümü, dağıttığınız n8n sürümünün özel gereksinimlerine tamamen bağlıdır, çünkü npm'in kendisi Node.js'in şu anda desteklenen tüm LTS sürümleriyle uyumludur. Resmi belgeler uyumluluk için bu kesin sürüm aralığını belirtir. terminalde `node --version` komutunu çalıştırarak geçerli sürümü kontrol edin.
Docker kurulumları Docker Engine veya Docker Desktop gerektirir. n8n ekibi, temiz izolasyon sağladığı ve işletim sistemi uyumsuzluklarını önlediği için çoğu kendi kendine barındırma ihtiyacı için Docker'ı önerir.
Sistem Gereksinimleri
Yerel n8n örnekleri Windows, macOS ve Linux sistemlerinde çalışır. Resmi belgelerde minimum RAM belirtimi görünmemektedir, ancak iş akışı karmaşıklığı gerçek kaynak ihtiyaçlarını belirler.
Kurulum başlangıçta minimum disk alanı tüketir. Depolama gereksinimleri, iş akışı verilerine, yürütme geçmişine ve özel düğüm paketlerine göre büyür.
Yöntem 1: n8n'i npm ile Çalıştırma
npm kurulumu, n8n'i yerel olarak çalıştırmak için en hızlı yolu sağlar. Bu yöntem, kapsülleme olmadan doğrudan ana sistem üzerinde çalışır.
npx ile Hızlı Başlangıç
En basit yaklaşım, kalıcı kurulum olmadan npx kullanır. Bir terminal açın ve şunu çalıştırın:
| npx n8n |
Bu komut gereken her şeyi indirir ve n8n'i otomatik olarak başlatır. Arayüz, birkaç saniye içinde localhost:5678 adresinde erişilebilir hale gelir.
npx yöntemi, test ve değerlendirme için mükemmel şekilde çalışır. Küresel npm paketleri veya kalıcı sistem değişiklikleri gerektirmez.
Küresel npm Kurulumu
Kalıcı kurulum için küresel npm paketi tutarlı erişim sağlar:
| npm install n8n -g |
Kurulum tamamlandıktan sonra, şunu çalıştırarak istediğiniz zaman n8n'i başlatın:
| n8n |
n8n'in mevcut ana kararlı sürümü 2.x'tir (örneğin, 2.10.4). Beta sürümleri kararsız özellikler içerebilir ve üretim iş akışları için kaçınılmalıdır.
Yapılandırma ve Veri Depolama
npm kurulumları, iş akışı verilerini varsayılan olarak ~/.n8n dizinine depolar. Bu konum kimlik bilgilerini, iş akışı tanımlarını ve yürütme geçmişini içerir.
Ortam değişkenleri n8n davranışını kontrol eder. Varsayılan 5678 bağlantı noktasını değiştirmek için N8N_PORT değişkenini ayarlayın. Diğer değişkenler veritabanı bağlantılarını, webhook URL'lerini ve kimlik doğrulama ayarlarını yapılandırır.
Yöntem 2: n8n'i Docker ile Çalıştırma
Docker kurulumu, yerel n8n barındırma için önerilen yaklaşımdır. Resmi belgeler, üretim kendi kendine barındırma ihtiyaçları için Docker'ı vurgular.
Temel Docker Çalıştırma Komutu
Tek bir Docker komutuyla n8n'i başlatın:
| docker run -it –rm –name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Bu komut, n8n adlı bir kapsayıcı oluşturur, 5678 numaralı bağlantı noktasını ana sisteme eşler ve ~/.n8n dizininde verileri kalıcı hale getirir.
-it bayrağıyla kapsayıcı etkileşimli olarak çalışır. Durdurduktan sonra kapsayıcıyı tutmak için --rm'yi kaldırın.
Üretim Kurulumu İçin Docker Compose
Docker Compose yapılandırmaları, üretim ortamları için daha iyi kontrol sağlar. GitHub'daki n8n-hosting deposu, çeşitli mimariler için kullanıma hazır Docker Compose dosyaları içerir.
Temel bir docker-compose.yml yapılandırması şuna benzer:
| version: ‘3.8’ services: n8n: image: n8nio/n8n restart: always ports: – “5678:5678” environment: – N8N_BASIC_AUTH_ACTIVE=true – N8N_BASIC_AUTH_USER=admin – N8N_BASIC_AUTH_PASSWORD=password volumes: – ~/.n8n:/home/node/.n8n |
Yığını şununla başlatın:
| docker-compose up -d |
-d bayrağı, kapsayıcıları ayrı modda çalıştırarak terminali diğer görevler için kullanmaya olanak tanır.
İlk Yapılandırma ve Erişim
n8n'i herhangi bir yöntemle başlattıktan sonra, bir web tarayıcısında localhost:5678 adresine gidin. İlk kurulum ekranı, yönetici hesabı için bir e-posta adresi ve şifre ister.
Bu ilk kullanıcı, tam yönetici ayrıcalıklarına sahip örnek sahibi olacaktır. Daha sonra kullanıcı yönetimi arayüzünden ek kullanıcılar eklenebilir.
Kimlik Doğrulama Kurulumu
Güvenlik için, yerel kurulumlarda bile kimlik doğrulamayı etkinleştirin. Docker Compose yapılandırmaları kimlik doğrulama ortam değişkenlerini doğrudan kabul eder:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
Bu değişkenler HTTP temel kimlik doğrulamasını etkinleştirir ve tüm erişim denemeleri için kimlik bilgileri gerektirir.
Özel Düğümleri Yerel Olarak Test Etme
Resmi belgeler, geliştirme sırasında özel düğümlerin nasıl test edileceğini açıklar. Öncelikle n8n'i küresel olarak kurun, ardından özel düğüm paketini derleyin ve bağlayın.
Özel düğüm dizininde şunu çalıştırın:
| npm run build npm link |
Ardından n8n düğümleri dizinine (genellikle ~/.n8n/custom/) gidin ve paketi bağlayın:
| npm link <node-package-name> |
Özel düğüm, örneği yeniden başlattıktan sonra n8n arayüzünde görünür.
n8n ile Kullanılacak Faydalı Otomasyon Kaynakları
n8n'i yerel olarak nasıl çalıştıracağınızı öğreniyorsanız ve makinenizde iş akışlarını test ediyorsanız, yaygın görevleri otomatikleştirmeyi kolaylaştıran harici yardımcılar ve şablonlardan da yararlanabilirsiniz. Get AI Perks, n8n ile birlikte kullanabileceğiniz veya otomasyon fikirlerini kendiniz oluşturmadan önce prototipini çıkarabileceğiniz iş akışı şablonları ve yapay zeka destekli araçlar sunar.
Get AI Perks ile şunları yapabilirsiniz:
- Önceden oluşturulmuş iş akışı şablonlarıyla başlayın
- Rutin mantık ve içerik için yapay zeka desteği alın
- n8n'de uygulamadan önce yaygın otomasyon desenlerini keşfedin
- Şablonları yerel n8n kurulumunuzla birleştirin
n8n iş akışlarınızı destekleyen otomasyon yardımcılarını bulmak için Get AI Perks'i keşfedin.
Yaygın Sorun Giderme
Bağlantı noktası çakışmaları en sık rastlanan kurulum sorunudur. 5678 numaralı bağlantı noktası zaten kullanılıyorsa, çakışan hizmeti durdurun veya N8N_PORT ortam değişkenini kullanarak n8n'in bağlantı noktasını değiştirin.
Düğüm Sürümü Uyumluluk Sorunları
20.19-24.x aralığı dışındaki Node.js sürümlerini kullanmak kurulum hatalarına neden olur. n8n GitHub deposu, geliştiricilerin yerel geliştirme ortamları denediğinde karşılaştıkları sorunları belgeler ve Node sürümü uyumluluğunun önemini vurgular.
Diğer sorunları gidermeden önce Node sürümü uyumluluğunu doğrulayın. Gerekirse nvm (Node Version Manager) kullanarak Node sürümlerini değiştirin.
Docker Birim İzin Hataları
~/.n8n birim bağlamasındaki izin sorunları, veri kalıcılığını engeller. Docker kapsayıcıları, ana dizine yazma erişimi olmayan düğüm kullanıcısı olarak çalışır.
Kapsayıcıyı başlatmadan önce dizini uygun izinlerle oluşturun:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Sıkça Sorulan Sorular
n8n internet erişimi olmadan çalışabilir mi?
Evet, n8n yerel iş akışları için tamamen çevrimdışı çalışır. İnternet bağlantısı yalnızca iş akışları harici API'lerle veya bulut hizmetleriyle etkileşime girdiğinde gereklidir.
n8n'i yerel olarak çalıştırmak ne kadara mal olur?
Yerel kurulumlar ücretsizdir. Topluluk sürümü, lisans ücretleri olmadan tüm temel özellikleri sunar. Bulut barındırma, yürütme limitleri ve aylık maliyetlerle başlar, ancak yerel barındırma topluluk tartışmalarına göre bu kısıtlamaları tamamen kaldırır.
Yeni başlayanlar npm mi yoksa Docker mı kullanmalı?
n8n'i test eden yeni başlayanlar, anında erişim için npx ile başlamalıdır. Docker, daha iyi izolasyon ve daha kolay yükseltmeler sağladığı için sürekli kullanım için daha anlamlıdır.
n8n iş akışı verilerini yerel olarak nereye depolar?
Varsayılan veri dizini, kullanıcının ev klasöründeki ~/.n8n'dir. Bu konum, aksi yapılandırılmadıkça SQLite veritabanı dosyalarını, kimlik bilgilerini ve yürütme günlüklerini içerir.
Tek bir makinede birden fazla n8n örneği çalıştırılabilir mi?
Evet, ancak her örneğin benzersiz bir bağlantı noktasına ihtiyacı vardır. Her örnek için N8N_PORT ortam değişkenini kullanarak farklı bağlantı noktaları ayarlayın. Docker, ayrı kapsayıcılardaki bağlantı noktası eşlemesi yoluyla bunu kolaylaştırır.
Yerel kurulumlar için güncellemeler nasıl çalışır?
npm kurulumları `npm update -g n8n` veya `npm install -g n8n@latest` aracılığıyla güncellenir. Docker kullanıcıları, `docker pull n8nio/n8n` ile en son görüntüyü çeker, ardından kapsayıcıları yeniden oluşturur. Güncellemeden önce her zaman ~/.n8n dizinini yedekleyin.
Üretim Hususları
Resmi n8n belgeleri, kendi kendine barındırmanın teknik bilgi gerektirdiğini vurgulamaktadır. Sunucuları kurmak, kaynakları yönetmek ve uygulamaları güvence altına almak, sistem yönetimi deneyimi gerektirir.
Üretim dağıtımları için Docker Compose temel oluşturur. HTTPS desteği için nginx veya Caddy gibi bir ters proxy ekleyin. n8n-hosting deposu, dağıtıma hazır Caddy yapılandırmaları içerir.
Yoğun iş yükleri için veritabanı seçimi önemlidir. Varsayılan SQLite veritabanı orta düzey kullanım için çalışır, ancak resmi rehbere göre PostgreSQL, yüksek hacimli otomasyon için daha iyi performans sunar.
Karar Verme: Yerel mi Bulut mu
Yerel n8n barındırma, teknik yeteneklere ve belirli güvenlik gereksinimlerine sahip ekipler için uygundur. Veriler kontrollü altyapıda kalır ve yürütme limitleri ortadan kalkar.
Ancak, yerel barındırma bakım, yedeklemeler ve izleme gerektirir. Bulut barındırma bu sorumlulukları n8n'in altyapı ekibine devreder. Güncel bulut fiyatlandırması ve özellik karşılaştırmaları için resmi web sitesini kontrol edin.
n8n'i yerel olarak çalıştırmak, iş akışı otomasyon altyapısı üzerinde tam kontrol sağlar. Hızlı test için npm veya üretim dağıtımları için Docker kullanıyor olun, her iki yöntem de yinelenen maliyetler olmadan tam platformu sunar. Anında keşif için npx ile başlayın, ardından iş akışları üretime yaklaştığında Docker'a geçin.
