n8n’i kullanmaya başlamanın üç yolu vardır: n8n Cloud’da hazır bir hesap açmak, kendi sunucunuza Docker ile kurmak ve bilgisayarınızda npm ile denemek. Doğru yöntem, amacınıza ve ekibinizin teknik yetkinliğine göre değişir. Bu rehberde her yöntemin ne zaman uygun olduğunu, temel komutları ve kurumsal kullanımda dikkat edilmesi gerekenleri özetliyoruz. n8n’in ne olduğunu henüz bilmiyorsanız önce n8n nedir ve ne işe yarar rehberine bakın.
Komutlar ve sürüm gereksinimleri n8n’in resmi dokümantasyonuna dayanır ve sürümle birlikte değişebilir. Kurulumdan önce resmi sayfaları kontrol edin.
Hangi kurulum yöntemi size uygun?
| Yöntem | Ne zaman uygun? | Dikkat edilecek nokta |
|---|---|---|
| n8n Cloud | Kurulum ve bakımla uğraşmadan hızlı başlamak istediğinizde | Verinin işlendiği altyapı ve bölge, kurumsal gereksinimlerle (örneğin KVKK) birlikte değerlendirilmelidir |
| Docker (self-hosted) | Kendi sunucunuzda, verinin kontrolü sizde kalacak şekilde çalıştırmak istediğinizde | Güncelleme, yedekleme ve güvenlik sorumluluğu kurumunuza aittir. Resmi dokümantasyon, kalıcı kurulumlar için Docker Compose kullanılmasını önerir |
| npm / npx | Bilgisayarınızda hızlıca denemek istediğinizde | Kalıcı kurulum için uygun değildir. Resmi dokümantasyon, npm tabanlı kurulumların n8n 3.0 sürümünden itibaren kullanımdan kaldırıldığını belirtir |
Hızlı deneme: npx ile
Bilgisayarınızda Node.js yüklüyse n8n’i kurmadan deneyebilirsiniz. Resmi dokümantasyona göre n8n, 20.19 ile 24.x arasındaki (uçlar dahil) Node.js sürümlerini gerektirir.
npx n8nBaşladıktan sonra n8n’e tarayıcıdan http://localhost:5678 adresiyle erişirsiniz. Bu yöntem öğrenme ve deneme içindir; ekibinizin kullanacağı kalıcı bir ortam için Docker’ı tercih edin.
Docker ile kurulum
Resmi Docker sayfasındaki temel komut dizisi şöyledir. Önce verilerin saklanacağı bir volume oluşturulur, ardından n8n çalıştırılır:
docker volume create n8n_data
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="Europe/Istanbul" \
-e TZ="Europe/Istanbul" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-v n8n_data:/home/node/.n8n \
n8nio/n8n- 5678 portu: n8n arayüzü http://localhost:5678 adresinde açılır.
- TZ ve GENERIC_TIMEZONE: TZ konteynerin sistem saatini, GENERIC_TIMEZONE ise Schedule Trigger gibi zamanlayıcı düğümlerinin saat dilimini belirler. Zamanlanmış akışlarda ikisini de doğru ayarlayın.
- n8n_data volume’u: /home/node/.n8n dizinine bağlanır. Verileriniz konteyner yeniden başlasa da korunur.
Bu komut deneme amaçlıdır. Resmi sayfa, kalıcı kurulumlar için Docker Compose’u önerir. Docker Compose ile güncelleme için sırasıyla docker compose pull, docker compose down ve docker compose up -d komutları kullanılır. Ayrıntılar için n8n’in Docker kurulum sayfasına ve npm yöntemi için npm kurulum sayfasına bakın.
Üretim ortamı için kontrol listesi
- Docker Compose kullanın. Yapılandırmanız bir dosyada durur, güncelleme ve yeniden kurulum tekrarlanabilir olur.
- Kararlı sürümü seçin. Resmi dokümantasyon, üretim için
stableetiketini önerir.betaetiketi kararsız olabilir. - PostgreSQL kullanın. n8n varsayılan olarak SQLite ile çalışır. Üretimde PostgreSQL için
DB_TYPE=postgresdbveDB_POSTGRESDB_*değişkenleri ayarlanır. - .n8n dizinini kalıcı tutun. PostgreSQL kullansanız bile bu dizin şifreleme anahtarlarını, günlükleri ve kaynak kontrol varlıklarını içerir. Kaybolursa kayıtlı kimlik bilgilerine erişemezsiniz.
- HTTPS ile yayınlayın. n8n’i internete açacaksanız bir ters vekil sunucu arkasında HTTPS kullanın. Webhook’ların dışarıdan erişilen adresle çalıştığını test edin.
- Tünel özelliğini üretimde kullanmayın. Tünel yalnızca yerel geliştirme ve test içindir, resmi dokümantasyona göre üretim için güvenli değildir.
- Yedekleyin. Veritabanını ve .n8n dizinini düzenli yedekleyin, geri yüklemeyi bir kez deneyin.
- Erişimi sınırlayın. Kullanıcıları ve yetkileri tanımlayın, sunucuya ağ erişimini gerekli adreslerle sınırlayın.
- Güncelleme planı yapın. Sürümleri kontrolsüz değil, test edip sonra uygulayın.
Yoğun iş yükü: kuyruk (queue) modu
Çok sayıda akışı aynı anda çalıştırmanız gerekiyorsa n8n’in kuyruk modu kullanılır. Bu modda ana örnek ve işçi (worker) örnekleri ayrı çalışır, işler bir Redis kuyruğu üzerinden dağıtılır. Resmi kuyruk modu sayfasına göre ana örnekte ve her işçide EXECUTIONS_MODE=queue ayarlanır ve şifreleme anahtarı tüm işçilerle paylaşılır ki kayıtlı kimlik bilgilerini okuyabilsinler. Kuyruk modu PostgreSQL gerektirir, SQLite desteklenmez. Küçük ekipler için çoğu zaman gerekmez; önce tek örnekle başlayıp ihtiyaç doğarsa geçmek daha sağlıklıdır.
Kurumsal kurulumda dikkat edilecekler
- Sorumluluk: n8n’in kendi dokümantasyonu, self-hosting’in sunucu yönetimi, ölçekleme, güvenlik ve n8n yapılandırma becerisi gerektirdiğini belirtir. Bu deneyim yoksa Cloud seçeneği daha güvenli bir başlangıçtır.
- Kişisel veri: Akışlardan geçen verinin türünü ve nerede işleneceğini baştan belirleyin. Self-hosted kurulum veriyi kurumunuzda tutar, Cloud’da altyapı ve bölge değerlendirilmelidir.
- Lisans: n8n, Sustainable Use License ile dağıtılır. Yazılımı yalnızca kendi iç iş amaçlarınız veya ticari olmayan kullanım için kullanabilirsiniz. Müşterilerinize ürün olarak sunmayı düşünüyorsanız lisansı ayrıca inceleyin.
- Seçim: n8n’i Zapier ve Make ile kıyaslamak için n8n, Make ve Zapier karşılaştırması yazımıza bakabilirsiniz.
Kurulumu eğitimde öğrenmek
BlueMark Academy’nin n8n ile Yapay Zeka Destekli Workflow Otomasyonu ve Agent Geliştirme Eğitimi müfredatında “Kurulum ve Teknik Altyapı” bölümü bulunur. Bu bölümde Repocloud kurulum örneği, ücretsiz kurulum seçeneği, ortamın hazırlanması ve HTTP webhook ile düğümler arasında akış oluşturma ele alınır. Eğitim 2 gün sürer ve kurumunuza özel planlanabilir.
Sık sorulan sorular
n8n kurulumu ücretsiz mi?
Kendi sunucunuzda çalıştırılan topluluk sürümünü ücretsiz kurabilirsiniz, ancak Sustainable Use License koşulları geçerlidir ve sunucu ile bakım maliyeti size aittir. n8n Cloud ücretlidir. Güncel plan ve koşullar için n8n’in resmi sayfalarına bakın.
n8n için hangi Node.js sürümü gerekir?
Resmi npm sayfasına göre n8n, 20.19 ile 24.x arasındaki Node.js sürümlerini gerektirir. Docker ile kurulumda Node.js’i ayrıca yüklemeniz gerekmez. Sürüm aralığı zamanla değişebileceği için kurulumdan önce resmi sayfayı kontrol edin.
n8n verileri nerede saklanır?
Varsayılan olarak SQLite veritabanında saklanır; kimlik bilgileri, çalıştırma geçmişi ve akışlar buradadır. Üretimde PostgreSQL kullanılması önerilir. Şifreleme anahtarlarını içeren .n8n dizininin de kalıcı tutulması gerekir.
n8n’i kurmak mı, n8n Cloud mu kullanmak daha iyi?
Hızlı başlamak ve bakım yükünden kaçınmak istiyorsanız Cloud, veri kontrolü ve maliyet esnekliği istiyor ve sunucuyu yönetebiliyorsanız self-hosted daha uygundur. Ayrıntılı değerlendirme için n8n nedir rehberindeki Cloud ve self-hosted bölümüne bakabilirsiniz.