n8n Nasıl Kurulur? Docker ile Adım Adım Kurulum

n8n nasıl kurulur?

n8n'i kurmanın iki yolu var: bulut sürümüne kaydolmak (kurulum yok, dakikalar içinde çalışır) veya kendi sunucunuza Docker ile kurmak (ücretsiz, ama bakım sizde). Kendi sunucunuza kuracaksanız standart yol Docker Compose ile n8n ve PostgreSQL'i birlikte ayağa kaldırmaktır.

Özet sıra şu:

• Bir Linux sunucu edinin ve Docker ile Docker Compose kurun
• n8n'i PostgreSQL veritabanıyla birlikte çalıştıracak yapılandırmayı hazırlayın
• Bir alan adı bağlayıp HTTPS sertifikası alın
• Şifreleme anahtarını üretin ve güvenli bir yerde saklayın
• Veritabanını ve anahtarı yedekleme planına dahil edin

Aşağıda her adımın neden gerektiğini ve atlandığında ne olduğunu tek tek yazdık. En çok atlanan adımlar dördüncü ve beşinci, ve en pahalıya çıkanlar da onlar.

n8n nasıl ücretsiz kullanılır?

n8n'i ücretsiz kullanmanın iki yolu var. Birincisi bulut sürümünün deneme süresi, kredi kartı istemez ama süresi dolar. İkincisi Community Edition, yani kendi sunucunuzda çalıştırdığınız sürüm: sınırsız iş akışı, sınırsız kullanıcı, bütün entegrasyonlar, lisans ücreti yok.

Community Edition'da olmayanlar: tek oturum açma (SSO/SAML/LDAP), Git ile sürüm kontrolü, ayrı test ve canlı ortamlar, gelişmiş kullanıcı rolleri, log akışı ve SLA'lı destek.

Burada dürüst olmak gerekiyor: lisans bedava, kurulum bedava değil. Sunucu kirası, güncelleme, yedekleme ve arıza anında müdahale sizin üzerinizde. Küçük ekiplerde bu iş genelde bir kişinin boş zamanına biner ve o kişi izne çıktığında sistem sahipsiz kalır. Ücretsiz sürüm kararı, teknik bir karar değil sahiplik kararıdır.

Kurulum için hangi sunucu yeterli?

Küçük ve orta ölçekli kullanım için 2 vCPU ve 4 GB RAM makul bir başlangıç, 40 GB disk yeterli. Bu, günde birkaç bin çalıştırmaya kadar rahat gider.

Kaynak ihtiyacını belirleyen şey çalıştırma sayısından çok ne yaptığınız:

• Basit veri aktarma akışları çok az kaynak tüketir
• Aynı anda çalışan çok sayıda akış varsa CPU belirleyici olur
• Büyük dosya işleyen, PDF okuyan veya görsel işleyen akışlar RAM tüketir
• Yapay zeka düğümleri kullanıyorsanız ağır iş modelin sunucusunda döner, sizin sunucunuzda değil, yani yükü sandığınız kadar artmaz

Daha küçük başlayıp gerektiğinde büyütmek doğru yaklaşım. Ama diski küçük tutmayın, çalıştırma geçmişi zamanla birikiyor ve dolu disk n8n'i sessizce durdurur.

Docker ile n8n kurulumu nasıl yapılır?

Docker Compose ile kurulum, n8n ve PostgreSQL'i tek yapılandırmada birlikte çalıştırmak anlamına geliyor. Uygulanacak sıra şöyle:

• Sunucuya Docker ve Docker Compose kurun
• Bir dizin açıp içine yapılandırma dosyanızı koyun: iki servis tanımlayacaksınız, biri PostgreSQL biri n8n
• PostgreSQL için kullanıcı adı, şifre ve veritabanı adını ortam değişkeni olarak verin, dosyanın içine açık yazmayın
• n8n servisine veritabanı bağlantı bilgilerini, kendi adresini (WEBHOOK_URL) ve şifreleme anahtarını geçirin
• Hem n8n verisi hem PostgreSQL verisi için kalıcı disk bağlayın, yoksa konteyner yenilendiğinde her şey gider
• Servisleri başlatın ve tarayıcıdan açıp ilk yönetici hesabını oluşturun

En sık yapılan hata kalıcı disk bağlamayı atlamak. Konteyner ilk güncellemede yeniden oluşturulur ve o ana kadar kurduğunuz her akış kaybolur. İkinci sık hata veritabanı şifresini yapılandırma dosyasına açık yazıp o dosyayı sürüm kontrolüne göndermek.

Neden SQLite yerine PostgreSQL kullanmak gerekir?

n8n varsayılan olarak SQLite ile çalışır ve bu denemek için yeterlidir, ama üretimde veri kaybı ve kilitlenme riski taşır. Eşzamanlı çalıştırma sayısı arttığında SQLite dosya kilidi sorunları çıkarır ve çalıştırma geçmişi büyüdükçe yavaşlar.

PostgreSQL'e geçmenin getirdikleri:

• Aynı anda çalışan çok sayıda akışı sorunsuz taşır
• Yedekleme ve geri yükleme standart araçlarla yapılır
• Veritabanını ayrı bir sunucuya taşıyabilir, n8n'i yatay büyütebilirsiniz
• Bozulma riski belirgin biçimde düşer

Geçişi baştan yapmak sonradan yapmaktan çok daha kolay. Sonradan geçmek, kurulu akışların ve kimlik bilgilerinin taşınması anlamına geliyor ve bu iş her zaman planlandığından uzun sürüyor. İlk kurulumda PostgreSQL ile başlamak, ileride yaşanacak bir taşınmayı tamamen ortadan kaldırıyor.

HTTPS ve alan adı neden zorunlu?

HTTPS olmadan webhook'lar güvenilir çalışmaz, çünkü çoğu servis (ödeme sağlayıcıları, CRM'ler, mesajlaşma platformları) webhook adresi olarak yalnızca HTTPS kabul eder. Alan adı da gerekiyor, çünkü IP adresine sertifika almak pratik değil ve sunucu değişince bütün entegrasyonları elle güncellemek zorunda kalırsınız.

Standart kurulum şöyle olur: bir alt alan adı (örneğin otomasyon.sirketiniz.com) n8n sunucusuna yönlendirilir, önüne bir ters vekil sunucu (Caddy, Traefik veya Nginx) konur, sertifika Let's Encrypt üzerinden otomatik alınır ve yenilenir.

Bir de n8n'e kendi adresini söylemeniz gerekiyor. WEBHOOK_URL ayarı yanlışsa n8n, dış servislere kendi iç adresini bildirir ve webhook'lar sessizce çalışmaz. Bu, kurulumdan sonra en sık karşılaşılan ve en çok zaman kaybettiren sorun, çünkü hata mesajı vermez, sadece hiçbir şey olmaz.

Şifreleme anahtarı neden kritik?

n8n, entegrasyonlar için kaydettiğiniz bütün kimlik bilgilerini (API anahtarları, şifreler, tokenlar) bir şifreleme anahtarıyla şifreleyerek saklar. Bu anahtarı kaybederseniz kayıtlı hiçbir kimlik bilgisi açılamaz ve hepsini tek tek yeniden girmek zorunda kalırsınız.

Yapılması gerekenler:

• Anahtarı kurulumda kendiniz üretip ortam değişkeni olarak verin, n8n'in üretmesine bırakmayın
• Anahtarı bir şifre yöneticisinde veya kurumsal sır deposunda saklayın
• Yedeklerinizin içinde anahtar olduğundan emin olun, veritabanı yedeği tek başına işe yaramaz
• Anahtarı sürüm kontrolüne asla göndermeyin

En kötü senaryo şu: sunucu çöker, veritabanı yedeği vardır ama anahtar yoktur. Bu durumda akışlar geri gelir, bağlantılar gelmez, ve otuz entegrasyonun kimlik bilgisini yeniden toplamak günler alır.

n8n nasıl güncellenir?

Docker kurulumunda güncelleme, yeni imajı çekip konteyneri yeniden oluşturmak anlamına gelir. Veriniz kalıcı diskte ve veritabanında olduğu için akışlarınız korunur.

Güvenli güncelleme sırası:

• Veritabanının yedeğini alın, güncelleme öncesi her seferinde
• Sürüm notlarını okuyun, özellikle ana sürüm atlamalarında kırıcı değişiklik olabiliyor
• Yeni imajı çekip servisleri yeniden başlatın
• Kritik akışlardan birini elle çalıştırıp doğrulayın

Otomatik güncellemeyi açmamanızı öneriyoruz. n8n hızlı geliştiriliyor ve düğüm davranışları sürümler arasında değişebiliyor. Gece otomatik güncellenen bir sunucuda sabah çalışmayan bir akış bulmak, güncelleme kazancından daha pahalı. Ayda bir planlı güncelleme, çoğu ekip için doğru ritim.

n8n kurulumu üretime hazır mı, neyi eksik?

Hayır. Çalışan bir n8n kurulumu, üretime hazır bir otomasyon altyapısı değildir. Kurulum işin başlangıcı, geri kalanı görünürlük ve sahiplik.

Üretim için eksik olanlar:

• Hata bildirimi: bir akış hata verdiğinde birinin haberi olmalı. Sadece log'a yazmak, kimsenin bakmadığı bir yere yazmak demek
• İzleme: sunucu ayakta mı, disk doluyor mu, çalıştırma süreleri uzuyor mu
• Yedek testi: yedeğinizi hiç geri yüklemediyseniz yedeğiniz olduğunu bilmiyorsunuz, umuyorsunuz
• Erişim yönetimi: kimin hangi akışı değiştirebileceği
• Belge: her akışın ne yaptığı ve hangi sistemlere bağlı olduğu

Bu beş maddesi olmayan kurulumlarda tipik hikâye şöyle işliyor: aylarca sorunsuz çalışır, sonra bir gün bir entegrasyonun anahtarı süresi dolduğu için akış durur, kimse fark etmez, ve eksik veri haftalar sonra başka bir yerden anlaşılır.

Kurulum yerine bulut sürümü ne zaman daha mantıklı?

Bulut sürümü şu üç durumda daha mantıklı: ekipte sunucu bakacak kimse yok, akışlar iş durdurucu değil ve veri bulutta durabiliyor. Bu üçü sağlanıyorsa, aylık ücret genelde harcanacak bakım zamanından ucuza geliyor.

Kendi sunucunuz şu durumlarda daha mantıklı: kişisel veya finansal veri işleniyor, mevzuat verinin yurt içinde kalmasını gerektiriyor, çalıştırma sayısı yüksek olduğu için bulut fiyatı öngörülemez hâle geliyor, ya da bağlanacağınız sistemler zaten kendi ağınızda.

Maliyet karşılaştırması yapılırken genelde sunucu kirası ile abonelik ücreti karşılaştırılıyor ve bu yanıltıcı oluyor. Doğru karşılaştırma, sunucu kirasına bakım zamanını da eklemek: ayda birkaç saatlik ilgi bile, çoğu ekipte abonelik ücretinden pahalı. Fiyatların ayrıntısını n8n nedir yazısında yazdık, kurulumu ve sonrasını sizin yerinize kurmamızı isterseniz otomasyon sistemlerimize bakabilirsiniz.