CapRover ile n8n Kurulumu: En Olgun PaaS ile One-Click Deploy

CapRover, 2017'den beri geliştirilen ve 13.000+ GitHub yıldızına sahip açık kaynaklı bir Platform as a Service (PaaS) çözümüdür. İş otomasyon aracı n8n'i CapRover üzerinde kurmak, geniş one-click app kataloğu sayesinde yalnızca birkaç dakika içinde mümkündür. Bu rehberde, n8n CapRover kurulumu yapacağınız adımları, HTTPS ve WebSocket yapılandırmasını tamamlayacağınızı öğreneceksiniz.

İçindekiler

1. CapRover Nedir?
2. 1. Adım: CapRover Kurulumu
3. 2. Adım: n8n'i One-Click App Olarak Deploy Etme
4. 3. Adım: HTTPS Aktifleştirme
5. 4. Adım: WebSocket Support Aktifleştirme
6. 5. Adım: Environment Variables Yapılandırması
7. 6. Adım: Erişim ve Hesap Oluşturma
8. CapRover'ın Avantajları
9. Sorun Giderme
10. Sonuç
11. Sıkça Sorulan Sorular

CapRover Nedir?

CapRover, Docker tabanlı uygulamaları kolay bir şekilde yönetmek ve deploy etmek için tasarlanan açık kaynaklı bir PaaS platformudur. Proje 2017'den beri geliştirilmekte ve toplam 13.000+ GitHub yıldızı almıştır. CapRover, Nginx reverse proxy ve Let's Encrypt SSL sertifikalarını otomatik olarak yönetir, böylece siz uygulamalarınıza odaklanabilirsiniz.

CapRover'ın en güçlü yanı, geniş bir one-click app kataloğu sunmasıdır. Bu katalogda WordPress, Nextcloud, GitLab, Strapi, PostgreSQL ve daha birçok popüler uygulama bulunur. n8n de bu katalog içinde yer alan uygulamalardan biridir, bu nedenle kurulum çok basittir. Ayrıca CapRover, çoklu uygulama desteği, Docker Compose deployment, persistent storage yönetimi ve command-line aracı (caprover) gibi gelişmiş özellikler sunar.

CapRover kullanmak için minimum 2 GB RAM ve 10 GB depolama alanına sahip bir Linux sunucusu yeterlidir. Küçük ve orta ölçekli işletmeler, geliştirici ekipleri ve hobbyistler için ideal bir çözümdür. Tamamen açık kaynak olması nedeniyle, hiçbir aylık ücret veya gizli maliyet yoktur.

1. Adım: CapRover Kurulumu

Docker Kurulumu (Ön Koşul)

CapRover, Docker konteyner motoruna bağımlı olduğundan, öncelikle Docker'ı kuralısınız. Eğer sunucunuzda Docker zaten kuruluysa, bu bölümü atlayabilirsiniz. Docker'ı kurmak için aşağıdaki komutları çalıştırın:

sudo apt update && sudo apt install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

İlk komut, paket yöneticisini günceller ve docker.io paketini yükler. İkinci komut, Docker daemon'unu başlatır. Üçüncü komut, sunucu yeniden başlatıldığında Docker'ın otomatik olarak çalışmasını sağlar.

CapRover Kurulumu

Docker kurulumunu tamamladıktan sonra, CapRover'ı aşağıdaki komut ile kurabilirsiniz:

docker run -p 80:80 -p 443:443 -p 3000:3000 \
  -e ACCEPTED_TERMS=true \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v captain-data:/captain \
  caprover/caprover

Bu komut, CapRover konteynerini başlatır ve aşağıdaki portları açar:

• 80: HTTP trafiği için
• 443: HTTPS trafiği için
• 3000: CapRover yönetim paneli için

Kurulum tamamlandıktan sonra, web tarayıcınızda http://SUNUCU_IP:3000 adresine gidin. Varsayılan kullanıcı adı ve şifre sırasıyla captain ve captain42 olur.

CapRover Setup Wizard

CapRover'a ilk kez giriş yaptığınızda, Setup Wizard ekranı açılır. Bu sihirbaz aşamasında aşağıdaki adımları tamamlamanız gerekir:

1. Domain Ayarı: Örneğin, *.apps.siteniz.com şeklinde bir wildcard domain belirleyin. CapRover, tüm uygulamalar için bu domain altında subdomainler oluşturacaktır.
2. Yeni Şifre Belirleme: Varsayılan şifreyi güçlü bir şifre ile değiştirin.
3. SSL Aktifleştirme: Let's Encrypt üzerinden otomatik SSL sertifikası almak için bu seçeneği aktifleştirin.

DNS Ayarları

CapRover'ın düzgün çalışması için DNS kayıtlarınızı yapılandırmalısınız. Domain sağlayıcınızın paneline giderek aşağıdaki kayıtları ekleyin:

• Wildcard A kaydı: *.apps.siteniz.com → SUNUCU_IP
• A kaydı: captain.apps.siteniz.com → SUNUCU_IP

Örneğin, siteniz example.com ise, *.apps.example.com ve captain.apps.example.com kayıtlarını oluşturmalısınız. DNS propagasyonu genellikle 24 saat içinde tamamlanır, ancak çoğu zaman daha hızlı olur.

2. Adım: n8n'i One-Click App Olarak Deploy Etme

CapRover panelinde sağ tarafta bulunan "Apps" sekmesine tıklayın. Ardından "One-Click Apps/Databases" bölümünü seçin. Açılan listede "n8n" arayın ve bulduğunuzda, n8n.io uygulamasını seçin.

Seçim yaptıktan sonra, bir yapılandırma formu görünecektir. Bu formda aşağıdaki alanları doldurun:

• App Name (Uygulama Adı): n8n yazın. CapRover, uygulamanızı n8n.apps.siteniz.com adresinde yayınlayacaktır.
• n8n Version (n8n Versiyonu): latest seçeneğini tercih edin, veya belirli bir versiyon numarası girin (örneğin, 1.50.0).
• Timezone (Saat Dilimi): Türkiye için Europe/Istanbul seçin.
• SMTP Ayarları (Opsiyonel): E-posta bildirimleri almak için SMTP sunucusu bilgilerini girin. Bu adım zorunlu değildir, ancak n8n'de e-posta gönderme görevleri için gerekli olabilir.

Tüm alanları doldurduktan sonra, "Deploy" butonuna tıklayın. CapRover, n8n uygulamasını Docker konteynerinde çalıştıracaktır. Deployment işlemi genellikle 2-5 dakika sürer.

3. Adım: HTTPS Aktifleştirme (KRİTİK)

n8n, güvenli bağlantı gerektiren bir uygulama olduğundan, HTTPS protokolünü aktifleştirmelisiniz. CapRover panelinde n8n uygulamasını bulup üzerine tıklayın. Açılan detay sayfasında, "Enable HTTPS" düğmesini göreceksiniz.

"Enable HTTPS" düğmesine tıklayın. CapRover, Let's Encrypt'den otomatik olarak bir SSL/TLS sertifikası alır. Bu işlem birkaç saniye içinde tamamlanır. Sertifika 90 gün geçerli olur ve CapRover otomatik olarak yeniler.

Ayrıca, aynı sayfada "Force HTTPS" seçeneğini de aktifleştirmenizi şiddetle önerilir. Bu seçenek, HTTP isteklerini otomatik olarak HTTPS'ye yönlendirir, böylece siz her zaman şifreli bağlantılar üzerinden çalışırsınız.

4. Adım: WebSocket Support Aktifleştirme (KRİTİK)

n8n'in editor arayüzü ve real-time güncellemeleri çalışması için WebSocket desteğini aktifleştirmelisiniz. n8n detay sayfasında, "HTTP Settings" veya "Networking" sekmesine giderek "WebSocket Support" seçeneğini bulun.

"WebSocket Support" kutusunu işaretleyip değişiklikleri kaydedin. Bu adım çok önemlidir; eğer WebSocket aktif değilse, n8n arayüzü yüklenmeyecek, workflow editörü yanıt vermeyecek ve realtime senkronizasyon çalışmayacaktır. WebSocket, n8n'in temel işlevselliğinin bir parçasıdır.

5. Adım: Environment Variables Yapılandırması

n8n'in doğru şekilde çalışması için, bazı ortam değişkenlerini (environment variables) yapılandırmalısınız. CapRover panelinde n8n uygulamasının "App Config" sekmesine gidin ve "Environment Variables" bölümünü açın.

Aşağıdaki ortam değişkenlerini ekleyin:

WEBHOOK_URL=https://n8n.apps.siteniz.com
N8N_PROTOCOL=https
GENERIC_TIMEZONE=Europe/Istanbul

• WEBHOOK_URL: n8n'in webhook işlevini kullanması için, uygulamanızın tam URL'sini burada belirtmeniz gerekir. Bu, harici sistemlerin n8n'e bağlanmasını sağlar.
• N8N_PROTOCOL: Protocol türünü https olarak ayarlayın. Bu, n8n'in HTTPS üzerinden çalışmasını sağlar.
• GENERIC_TIMEZONE: Saat dilimini belirtin. Türkiye için Europe/Istanbul kullanın.

Ek olarak, daha gelişmiş konfigürasyon için şu değişkenleri de ekleyebilirsiniz:

N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=güçlü_şifre
DB_SQLITE_PATH=/data/n8n.db

Ortam değişkenlerini ekledikten sonra, "Save & Update" butonuna tıklayarak değişiklikleri uygulaması sağlayın. CapRover, n8n konteynerini yeniden başlatacaktır.

6. Adım: Erişim ve Hesap Oluşturma

Tüm yapılandırma adımlarını tamamladıktan sonra, web tarayıcınızda https://n8n.apps.siteniz.com adresine gidin. n8n'in ana sayfası yüklenecektir.

İlk erişimde, sahip hesabı (owner account) oluşturmalısınız. Kullanıcı adı, e-posta adresi ve güçlü bir şifre belirleyin. Bu hesap, n8n'de en yüksek yetkilere sahip olacak ve tüm workflow'ları, entegrasyonları ve ayarları yönetebilecektir.

Hesabı oluşturduktan sonra, n8n panosuna (dashboard) yönlendirileceksiniz. Burada yeni workflow'lar oluşturabilir, mevcut workflow'ları düzenleyebilir ve n8n'nin tüm özelliklerini kullanabilirsiniz. n8n kurulumu rehberimize göz atarak n8n hakkında daha fazla bilgi alabilirsiniz.

İlk Workflow Testi

n8n'nin düzgün çalışıp çalışmadığını kontrol etmek için, basit bir test workflow'u oluşturun. Örneğin, "Start" nodu ile başlayıp, "Notification" nodu aracılığıyla bir test mesajı gönderin. Workflow'u çalıştırarak (play butonu), n8n'nin yanıt verip vermediğini doğrulayabilirsiniz.

CapRover'ın Avantajları

CapRover, n8n kurulumu için idealdir ve birçok avantaj sunmaktadır:

Nginx Reverse Proxy: CapRover, Nginx reverse proxy kullanarak yüksek performanslı bağlantı yönetimi sağlar. Aynı sunucu üzerinde çalışan birden fazla uygulamanın trafiğini verimli bir şekilde yönlendirir.

Çoklu Uygulama Desteği: Tek bir CapRover örneği üzerinde n8n, PostgreSQL, Redis, Nextcloud gibi birçok uygulamayı çalıştırabilirsiniz. Tüm uygulamalar otomatik olarak wildcard domain ile erişilebilir hale gelir.

Docker Compose Deployment: Eğer özel bir Docker Compose yapılandırması gerekiyorsa, CapRover bu dosyaları doğrudan deploy eder. Kompleks çok-konteyner yapılarını kolayca yönetebilirsiniz.

Persistent Storage (Kalıcı Depolama): CapRover, container'lar yeniden başlatılsa bile verilerinizin kaybolmaması için kalıcı depolama birimleri (volumes) otomatik olarak yönetir. n8n'nin tüm workflow'ları ve ayarları güvende kalır.

Let's Encrypt SSL Sertifikaları: Tüm uygulamalar için HTTPS şifreli bağlantısı otomatik olarak sağlanır. Sertifikalar 90 gün geçerlidir ve CapRover otomatik yenileme işlemini yönetir.

CLI Aracı (caprover): Terminal aracılığıyla CapRover'ı kontrol etmek istiyorsanız, caprover command-line aracını kullanabilirsiniz. Deployment, güncelleştirmeler ve yönetim işlemlerini otomasyonla yapabilirsiniz.

Açık Kaynak ve Ücretsiz: CapRover tamamen açık kaynaklı olduğundan, kaynak kodunu inceleyebilir ve kendi ihtiyaçlarınıza göre özelleştirebilirsiniz. Herhangi bir aylık ücret veya lisans maliyeti yoktur.

Sorun Giderme

n8n ve CapRover kurulumu sırasında bazı sorunlarla karşılaşabilirsiniz. İşte en yaygın sorunlar ve çözümleri:

n8n Arayüzü Yüklenmiyor

Sorun: n8n'i açtığınızda sayfa boş kalıyor veya arayüz yüklenmiyor.

Çözüm: Neredeyse kesin olarak WebSocket Support etkinleştirilmemiş demektir. CapRover panelinde n8n uygulamasına gidin, HTTP Settings bölümünde "WebSocket Support" kutusunun işaretli olduğundan emin olun. Değişiklikleri kaydettikten sonra tarayıcınızda sayfayı yenileyin (F5 veya Ctrl+Shift+R).

SSL/TLS Sertifika Hatası

Sorun: https://n8n.apps.siteniz.com adresine erişmeye çalıştığınızda sertifika uyarısı alıyorsunuz.

Çözüm: Öncelikle DNS propagasyonunun tamamlanıp tamamlanmadığını kontrol edin. Terminal'de nslookup n8n.apps.siteniz.com komutunu çalıştırın ve doğru IP adresinin dönüp dönmediğini görün. DNS propagasyonu 24 saat kadar sürebilir. Eğer DNS doğru yapılandırılmışsa, "Enable HTTPS" düğmesine tekrar tıklayarak sertifikayı yeniden alın.

Webhook Çalışmıyor

Sorun: n8n workflow'unuzda webhook trigger kullanıyor ancak harici sistem tetikleyemiyor.

Çözüm: Ortam değişkenlerini kontrol edin. WEBHOOK_URL değişkeninin https://n8n.apps.siteniz.com olarak doğru şekilde ayarlandığından emin olun. Ayrıca, webhook'un tam URL'sinin doğru olduğundan emin olun. n8n panosunda webhook'un yapılandırmasını kontrol edin ve test gönderi yapın.

Uygulama Çok Yavaş

Sorun: n8n arayüzü açılıyor ama çok yavaş çalışıyor veya workflow'lar uzun sürede çalışıyor.

Çözüm: Sunucunuzun kaynakları (RAM, CPU) yeteriyle mi denetleyin. CapRover kendisi yaklaşık 300 MB RAM kullanır, n8n ise 500 MB-1 GB arasında tüketebilir. Toplam kullanımınız 2 GB RAM'i aşmışsa, sunucunuzda başka çalışan konteynerler olabilir. Docker komutları ile konteyner kaynak kullanımını gözlemleyin:

docker stats

Eğer RAM problemi varsa, sunucunuzun RAM'ini artırmayı veya gereksiz konteynerları silmeyi düşünün.

Environment Variables Değişmiyor

Sorun: Ortam değişkenlerini CapRover'da eklediniz ama n8n bunları okumuyor gibi görünüyor.

Çözüm: Ortam değişkenlerini ekledikten sonra mutlaka "Save & Update" butonuna tıklayın. Bu düğme olmadan değişiklikler uygulanmaz. Değişiklikleri kaydettikten sonra, n8n konteynerinin yeniden başlatılmasını bekleyin (genellikle 30 saniye). Daha sonra tarayıcı önbelleğini temizleyin (Ctrl+Shift+Delete) ve sayfayı yenileyin.

Sonuç

CapRover ile n8n kurulumu, açık kaynak ve özgür yazılıma inanan, kendi altyapılarını kontrol etmek isteyen profesyoneller ve işletmeler için ideal bir çözümdür. CapRover'ın güçlü one-click app kataloğu, HTTPS otomasyonu ve Docker tabanlı mimarisi, n8n'i güvenle ve hızla deploy etmenizi sağlar.

Bu rehberi takip ederek, yalnızca birkaç dakika içinde enterprise-grade bir iş otomasyon platformunu kendi sunucunuzda çalıştırabilirsiniz. HTTPS ve WebSocket desteğini etkinleştirmeyi unutmayın; bunlar n8n'in düzgün çalışması için kritik öneme sahiptir. Ortam değişkenlerini doğru şekilde yapılandırarak, webhook'lar, e-posta entegrasyonları ve diğer dış sistem bağlantılarını sorunsuz şekilde kullanabilirsiniz.

CapRover ve n8n kombinasyonu, workflow otomasyon, veri sinkronizasyonu, API entegrasyonları ve çok daha fazlası için sonsuz olanaklar sunar. Başarılı bir deployment sonrasında, n8n'in tüm özelliklerini keşfetmeye başlayabilir ve kendi iş süreçlerinizi otomatikleştirebilirsiniz. Kendi sunucunuzda n8n çalıştırması, veri güvenliği, özelleştirme özgürlüğü ve uzun vadeli maliyet tasarrufu sağlar. İlk adımları şimdi atıp, iş otomasyon yolculuğunuza başlayın.

Daha fazla teknik destek veya ileri konfigurasyonlar için, n8n resmi dokumentasyonunu ve CapRover resmi sitesini ziyaret edebilirsiniz. Herhangi bir sorun yaşarsanız, topluluklarda ve forumlarında başka kullanıcılar size yardımcı olmaya hazırdır.

Sıkça Sorulan Sorular

S: CapRover nedir ve ne için kullanılır?

C: CapRover, 2017'den beri geliştirilen 13.000+ GitHub yıldızına sahip açık kaynaklı bir PaaS (Platform as a Service) platformudur. Docker tabanlı uygulamaları tek tıkla deploy etmenizi, HTTPS ile koruyup Nginx reverse proxy aracılığıyla yönetmenizi sağlar. CapRover sayesinde, n8n, WordPress, Nextcloud, PostgreSQL gibi kompleks uygulamaları kendi sunucunuzda sanki bulut hizmeti gibi çalıştırabilirsiniz.

S: CapRover ne kadar RAM ve depolama alanı kullanır?

C: CapRover kendisi yaklaşık 300 MB RAM tüketir. n8n uygulamasıyla birlikte toplam 800 MB ile 1 GB arasında RAM kullanımı olur. Başlangıç için minimum 2 GB RAM'e sahip bir sunucu yeterlidir. Depolama açısından ise, CapRover kendisi yaklaşık 500 MB yer kaplar; n8n ise workflow'lar ve veritabanı dahil 1-2 GB depolama alanı gerektirebilir. Daha fazla workflow ve daha büyük veri hacimleriyle çalışacaksanız, depolama alanını buna göre ayarlayın.

S: CapRover'da n8n deploy ettikten sonra hangi adımlar kritik önem taşır?

C: HTTPS ve WebSocket Support'u mutlaka aktifleştirmeniz gerekir. Bunlar n8n'in güvenli ve düzgün çalışması için zorunludur. HTTPS olmadan, web tarayıcısı n8n'ye güvenli bağlantı reddeder. WebSocket olmadan ise, n8n editörü yüklenmez, workflow'lar realtime güncellemez ve arayüz yanıt vermez. Bu iki adım atlanırsa, n8n kullanılamaz durumda kalır.

S: CapRover tamamen ücretsiz midir?

C: Evet, CapRover tamamen ücretsiz ve açık kaynak bir projedir. Hiçbir aylık ücret, lisans maliyeti veya gizli ödeme yoktur. Yalnızca sunucunuzun kira veya satın alma maliyetini karşılamanız gerekir. Eğer kendi fiziksel sunucunuz varsa, CapRover kurup tamamen ücretsiz şekilde kullanabilirsiniz.

S: n8n'i CapRover'da deploy ettikten sonra nasıl güncellerim?

C: CapRover panelinde n8n uygulamasını bulun ve detay sayfasını açın. "Deployment" sekmesine gidin. Docker imaj versiyonunu belirten alanda, eski versiyon yerine yeni versiyon numarası yazın (örneğin, 1.50.0 yerine 1.51.0). Ardından "Save & Update" butonuna tıklayın. CapRover, yeni versiyonun imajını indirecek, mevcut konteyneri durdurarak yeni sürümü başlatacaktır. Verileriniz ve workflow'larınız korunur.

S: CapRover ile birden fazla uygulamayı aynı sunucu üzerinde çalıştırabilir miyim?

C: Evet, kesinlikle. CapRover'ın ana güçlerinden biri, çoklu uygulama desteğidir. Aynı sunucu üzerinde n8n, PostgreSQL, Redis, Nextcloud, WordPress ve onlarca diğer uygulamayı çalıştırabilirsiniz. Tüm uygulamalar otomatik olarak farklı subdomainlerde (n8n.apps.siteniz.com, db.apps.siteniz.com vb.) çalışır ve Nginx reverse proxy aracılığıyla yönetilir.

S: n8n'in webhook özelliğini CapRover'da nasıl kullanırım?

C: Webhook'lar için WEBHOOK_URL ortam değişkenini https://n8n.apps.siteniz.com olarak ayarlamanız gerekir. n8n panosunda bir workflow oluşturduktan sonra, "Webhook" trigger'ını ekleyin. n8n, webhook URL'sini otomatik olarak üretecektir (örneğin, https://n8n.apps.siteniz.com/webhook/unique-id). Bu URL'yi harici uygulamalara (Zapier, GitHub Actions vb.) verdiğinizde, o uygulamalar n8n workflow'unuzu tetikleyebilir.

S: CapRover'daki n8n verilerini yedeklemeyi nasıl yaparım?

C: CapRover, n8n'in verilerini Docker volume'leri içinde saklı tutar. Yedekleme için iki yöntem vardır: (1) CapRover panosunda backup özelliğini kullanmak veya (2) Docker komut satırında docker inspect komutuyla volume yolunu bulup, tar komutu ile sıkıştırılmış yedek almak. Daha kolay bir yöntem ise, n8n'nin kendi export özelliğini kullanarak workflow'larınızı JSON dosya olarak dışa aktarmaktır.

S: n8n CapRover'da çok yavaş çalışıyorsa ne yapmalıyım?

C: Performans sorunları genellikle RAM yetersizliğinden kaynaklanır. docker stats komutu ile konteyner kaynak kullanımını kontrol edin. Eğer n8n sık sık RAM limitlerine çarpıyorsa, sunucunuzun belleğini artırmayı veya gereksiz konteynerları kaldırmayı düşünün. Ayrıca, n8n panosunda çalışan workflow sayısını azaltmayı veya ağır işlemçi-yoğun workflow'ları optimize etmeyi deneyebilirsiniz.

S: CapRover'da n8n için custom domain kullanabilir miyim?

C: Evet. CapRover setup wizard'da wildcard domain belirledikten sonra, n8n için istediğiniz subdomain adını ekleyebilirsiniz. Örneğin, apps.siteniz.com yerine n8n.siteniz.com kullanmak istiyorsanız, CapRover panosunda n8n uygulamasının domain ayarlarını değiştirebilirsiniz. Ardından, domain sağlayıcınızda custom domain'in A kaydını sunucu IP'sine yönlendirmeniz gerekir.