n8n Coolify Kurulumu: One-Click Deploy Rehberi

Coolify ile n8n Kurulumu: One-Click Deploy ile Dakikalar İçinde Hazır
Coolify, 35.000'den fazla GitHub yıldızıyla son dönemin en popüler açık kaynaklı self-hosted PaaS platformudur. Heroku, Vercel ve Netlify gibi ticari platformların sunduğu özellikleri, kendi sunucunuza kurarak tamamen kontrol altında tutabilirsiniz. Coolify'ın en büyük avantajlarından biri ise 100'den fazla uygulamayı one-click deploy ile anında kurabilmenizdir.
n8n dünyada en popüler workflow automation aracı olup, binlerce entegrasyonla iş otomasyonunuzun temelini oluşturur. Ancak n8n'i doğru şekilde kurmak, sunucu yapılandırması, veritabanı ayarları ve SSL sertifikaları gerektirdiğinden karmaşık bir süreçtir. İşte burada n8n Coolify kurulumu devreye girer ve tüm bu karmaşıklığı ortadan kaldırarak, production-ready bir n8n setup'ını sadece birkaç tıkla oluşturmanızı sağlar.
Bu rehberde, Coolify kurulumundan başlayarak n8n deploy'ına, SSL yapılandırmasına ve ileri ayarlara kadar tüm adımları öğreneceksiniz. Sonunda, kendi sunucunuzda çalışan, otomatik yedeklemesi olan ve monitoring özellikleri bulunan enterprise-grade bir n8n sistemi oluşturabileceksiniz.
İçindekiler
- Coolify Nedir?
- Adım 1: Coolify Kurulumu
- Adım 2: Yeni Proje Oluşturma
- Adım 3: n8n Servisini Deploy Etme
- Adım 4: Domain ve SSL Yapılandırması
- Adım 5: Environment Variables
- Adım 6: Deploy ve Erişim
- Coolify'ın Ekstra Özellikleri
- Sorun Giderme
- Sonuç
- Sıkça Sorulan Sorular
Coolify Nedir?
Coolify, açık kaynaklı bir self-hosted PaaS (Platform as a Service) platformudur. Basitçe ifade etmek gerekirse, Coolify sayesinde kendi sunucunuzda Heroku, Vercel ve Netlify gibi ticari platformların sunduğu rahatlığı yaşayabilirsiniz. Docker tabanlı yapısı sayesinde, binlerce uygulamayı tek komutla deploy edebilirsiniz.
Coolify'ın temel özellikleri şunlardır:
- One-Click Deploy: 100'den fazla popüler uygulamayı hazır template'lerle kurabilirsiniz
- Otomatik SSL Sertifikası: Let's Encrypt entegrasyonu ile tüm domain'ler otomatik olarak HTTPS ile korunur
- Dahili Monitoring: CPU, RAM, disk ve network kullanımını gerçek zamanlı izleyebilirsiniz
- Otomatik Yedekleme: Veritabanlarınızı belirli aralıklarla otomatik olarak yedekleyebilirsiniz
- Multi-Server Support: Birden fazla fiziksel sunucuyu tek panelden yönetebilirsiniz
- GitHub/GitLab Entegrasyonu: Git repository'nizden otomatik deploy edebilirsiniz
- Webhook Desteği: Tetikleyiciler ve otomasyonlar tanımlayabilirsiniz
Coolify, yalnızca n8n için değil, WordPress, Ghost, Strapi, RocketChat, MinIO ve çok daha fazla uygulamanın kurulumunu basitleştirir. Ancak bu rehber özellikle n8n kurulumuna odaklanmıştır.
1. Adım: Coolify Kurulumu
Coolify'ı kurmaya başlamadan önce, uygun bir ortama sahip olduğunuzdan emin olmalısınız. Yeterli sistem kaynakları ayırdığınız zaman Coolify ve n8n sorunsuz çalışır.
Sistem Gereksinimleri
Coolify ve n8n'i çalıştırabilmek için aşağıdaki minimum gereksinimleri karşılamalısınız:
- VPS/Sunucu: Linode, DigitalOcean, AWS, Google Cloud, Hetzner veya herhangi bir sağlayıcı
- İşletim Sistemi: Ubuntu 22.04 LTS, Ubuntu 24.04 veya Debian 12
- RAM: 2 GB minimum (4 GB önerilir, 8 GB ideal)
- Storage: SSD 20 GB minimum (50 GB önerilir)
- CPU: 1 vCore minimum (2 vCore önerilir)
- Root Erişimi: SSH üzerinden root veya sudo haklarına sahip olmak gerekir
Kurulum Komutu
Coolify'ı kurmak son derece basittir. SSH ile sunucunuza bağlandıktan sonra, aşağıdaki tek komutu çalıştırın:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bashBu komut, Coolify'ın tüm gerekli bileşenlerini (Docker, Docker Compose, Coolify servisleri vb.) otomatik olarak indirir ve kurar. Kurulum işlemi, sunucunuzun internet bağlantısına ve hızına bağlı olarak 5-15 dakika arasında sürer.
Kurulum Sonrası İlk Adımlar
Kurulum tamamlandığında, Coolify size aşağıdaki bilgileri gösterecektir:
Coolify is running at: http://YOUR_SERVER_IP:8000
Create your account and get started!Tarayıcınızda http://SUNUCU_IP:8000 adresine giderek Coolify panosuna erişin. İlk kez girdiğinizde, yönetici hesabınızı oluşturmalısınız:
- Email: Kullanmak istediğiniz email adresini girin
- Şifre: Güçlü bir şifre belirleyin (en az 8 karakter, büyük-küçük harf, sayı)
- Sunucu Bağlantısı: Coolify, kendisini çalıştırdığı sunucuya otomatik olarak bağlanır (localhost)
Kayıt olduktan sonra Coolify panosuna erişeceksiniz. İlk sayfada boş projeler listesi göreceksiniz. Artık n8n deploy etmeye hazırsınız.
2. Adım: Yeni Proje Oluşturma
Coolify'da her uygulama bir Proje içinde yer alır. Projeler, benzer uygulamaları gruplandırmak ve organize etmek için kullanılır. Örneğin, tüm workflow automation uygulamalarınız için bir "Automation" projesi, tüm blog uygulamalarınız için bir "Content" projesi oluşturabilirsiniz.
n8n deploy etmek için yeni bir proje oluşturalım:
- Coolify dashboard'ında, sol tarafta "Projects" seçeneğini bulun
- "New Project" butonuna tıklayın
- Proje Adı: "n8n-automation" girin
- Proje Açıklaması (isteğe bağlı): "Production n8n instance with PostgreSQL and Redis"
- Oluştur butonuna tıklayın
Proje oluşturulduktan sonra, içine yeni bir Environment eklemeniz gerekir. Environment'lar, development, staging, production gibi ortamları ayırmanız için kullanılır.
- Yeni oluşturulan projeyi açın
- "New Environment" butonuna tıklayın
- Environment Adı: "production" girin
- Sunucu Seçimi: Coolify'ı kurulu olduğunuz sunucuyu seçin
- Kaydet butonuna tıklayın
Artık n8n'i deploy etmeye hazırsınız. Production environment'ı açılı durumda tutun.
3. Adım: n8n Servisini Deploy Etme
Bu adım, Coolify'ın en güçlü özelliğini gösterecektir. n8n'i sıfırdan kurmanız saatler sürebilirken, Coolify'da yalnızca birkaç tıkla deploy edersiniz.
- Production environment'ında, "Add New Resource" butonuna tıklayın
- "Service" seçeneğini seçin (Database, Storage gibi diğer seçenekler de vardır)
- Açılan servislerin listesinde, "n8n" arayın
- n8n seçeneğine tıklayın
Coolify, n8n için hazır bir template sunar. Bu template, aşağıdaki bileşenleri otomatik olarak yapılandırır:
- n8n Main Instance: n8n workflow engine'inin ana instance'ı
- n8n Worker: Arka plan işlerini işleyen worker process'leri
- PostgreSQL Database: Workflow'lar, credentials ve execution history'si depolayan veritabanı
- Redis: Message queue, session depolama ve caching için kullanılan in-memory database
Coolify bu template'i seçince, otomatik olarak aşağıdaki yapılandırmaları yapar:
Services:
n8n:
image: n8n:latest
depends_on:
- postgres
- redis
postgres:
image: postgres:16-alpine
environment:
POSTGRES_DB: n8n
POSTGRES_USER: n8n
POSTGRES_PASSWORD: [auto-generated]
redis:
image: redis:latestCoolify'ın bu otomasyonu, manuel kurulumda yapılan onlarca satırlı konfigurasyonu tamamen ortadan kaldırır. Bu, kurulum sürenizi haftalarca azaltır ve hata riskini minimuma indirir.
4. Adım: Domain ve SSL Yapılandırması
n8n'i dünyaya açmak için bir domain'e ihtiyacınız vardır. Ayrıca, güvenlik açısından HTTPS (SSL) şifrelemesi zorunludur. n8n, özellikle webhook ve credential'lar ile çalışırken, SSL olmadan güvenli çalışamaz.
Coolify, Let's Encrypt entegrasyonu sayesinde bu işlemi tamamen otomatik hale getirir.
Domain Ekleme
-
n8n servisinde, "Settings" sekmesine gidin
-
"Domain" bölümünde, "Add Domain" butonuna tıklayın
-
Aşağıdaki alanları doldurun:
- Domain:
n8n.siteniz.com(kendi domain'iniz) - Port: 443 (HTTPS port, otomatik)
- SSL Certificate: "Generate with Let's Encrypt" seçin
- Domain:
-
Kaydet butonuna tıklayın
DNS Yapılandırması
Domain'izi ekledikten sonra, DNS kayıtlarınızı güncellemelissiniz. Domain'inizi yönettiğiniz panele (Namecheap, GoDaddy, Cloudflare, vb.) giderek, bir A Record veya CNAME Record ekleyin:
Type: A
Name: n8n
Value: SUNUCU_IP_ADRESIveya
Type: CNAME
Name: n8n
Value: siteniz.comDNS değişiklikleri 5 dakika ile 48 saat arasında yaygınlaşır. Coolify, DNS'in doğru şekilde ayarlandığını kontrol edince, otomatik olarak Let's Encrypt sertifikasını alır ve yapılandırır.
SSL Sertifikası Doğrulama
- Coolify panosına dönün
- n8n servisinde, Deployments sekmesini kontrol edin
- "SSL Certificate created successfully" mesajını göreceksiniz
Artık n8n'iniz HTTPS üzerinden güvenli bir şekilde çalışacaktır. Tarayıcıda https://n8n.siteniz.com adresinde yeşil kilitli bir bağlantı göreceksiniz.
5. Adım: Environment Variables
n8n'in doğru şekilde çalışması için, belirli ortam değişkenleri (environment variables) ayarlanmalıdır. Bu değişkenler, n8n'in davranışını, güvenliğini ve entegrasyonlarını kontrol eder.
Ana Ortam Değişkenleri
Coolify'da n8n servisinin Settings sekmesine gidin ve aşağıdaki ortam değişkenlerini ayarlayın:
N8N_HOST=n8n.siteniz.com
N8N_PROTOCOL=https
NODE_ENV=production
WEBHOOK_URL=https://n8n.siteniz.com
GENERIC_TIMEZONE=Europe/Istanbul
N8N_SECURE_COOKIE=true
N8N_ENCRYPTION_KEY=generate_random_key_hereHer bir değişkenin açıklaması:
- N8N_HOST: n8n'in erişileceği domain adı (SUNUCU_IP yerine domain kullanın)
- N8N_PROTOCOL: https (SSL kullanıyorsanız, kesinlikle https olmalı)
- NODE_ENV: production (performans optimizasyonları etkinleştirir)
- WEBHOOK_URL: Harici sistemlerin n8n'e bağlanması için webhook base URL'i
- GENERIC_TIMEZONE: Workflow'ların çalıştığı saat dilimi (Türkiye için Europe/Istanbul)
- N8N_SECURE_COOKIE: true (SSL kullanıyorsanız mutlaka true olmalı)
- N8N_ENCRYPTION_KEY: Credentials ve gizli verileri şifrelemek için anahtar (güvenlik için gerekli)
N8N_ENCRYPTION_KEY Oluşturma
Güvenlik anahtar rastgele bir string olmalıdır. Eğer mevcut bir anahtarınız yoksa, aşağıdaki komut ile oluşturabilirsiniz:
openssl rand -hex 32Komutu çalıştırıp çıkan sonucu (örn: a1b2c3d4e5f6g7h8...) N8N_ENCRYPTION_KEY olarak yapıştırın.
İleri Ayarlar (İsteğe bağlı)
Daha ileri özellikler için bu ek değişkenleri de ayarlayabilirsiniz:
# İzin verilen domain'ler (CORS)
N8N_ALLOWED_IFRAME_HOST_NAMES=*.siteniz.com
# Webhook rate limiting
N8N_WEBHOOK_TUNNEL_URL=https://n8n.siteniz.com
# Cluster modunda worker'lar için
N8N_EXECUTION_MODE=queue
N8N_EXECUTION_DATA_PRUNE_HARD_DELETE_INTERVAL=1 h
N8N_EXECUTION_DATA_MAX_AGE=336 hBu ayarlar isteğe bağlı olsa da, production ortamında performans ve güvenlik açısından önemliydi.
SSL Certificate Bypass (Eğer Gerekirse)
Nadir durumlarda, Coolify SSL sertifikasını alırken hatalar oluşabilir (DNS propagation gecikmeleri, firewall sorunları vb.). Bu durumda, geçici olarak aşağıdaki değişkeni ekleyin:
N8N_SECURE_COOKIE=falseAncak bunu yalnızca testing amaçlı ve kısaca kullanın. Production'da kesinlikle true olmalıdır.
6. Adım: Deploy ve Erişim
Tüm ayarlamaları tamamladıktan sonra, n8n'i deploy etmeye hazırsınız. Bu aşama, tüm konfigürasyonları aktif hale getirir ve n8n servisini başlatır.
Deploy İşlemi
- n8n servisinin ana sayfasında, "Deploy" veya "Redeploy" butonuna tıklayın
- Build loglarını takip edin: Aşağıda gerçek zamanlı logları göreceksiniz:
[2024-03-14 10:45:23] Pulling image n8n:latest...
[2024-03-14 10:46:12] Building n8n service...
[2024-03-14 10:47:45] Creating PostgreSQL database...
[2024-03-14 10:48:20] Starting Redis...
[2024-03-14 10:49:50] Starting n8n main instance...
[2024-03-14 10:50:15] Creating worker process...
[2024-03-14 10:51:00] Deploy successful!Loglar sorun göstermiyorsa, deployment 3-5 dakika arasında tamamlanır.
n8n'e Erişim
Deploy tamamlandıktan sonra:
-
Tarayıcıda
https://n8n.siteniz.comadresine gidin -
Boş bir giriş sayfası göreceksiniz (bu normaldir)
-
"Set up your instance" seçeneğini seçin
-
Admin hesabınızı oluşturun:
- Email: Kullanmak istediğiniz email
- Şifre: Güçlü bir şifre
- İsim: Tercihen tam adınız
-
Hesap Oluştur butonuna tıklayın
Artık n8n tamamen hazır ve kullanıma açık durumdadır. İlk workflow'unuzu oluşturmaya başlayabilirsiniz.
Coolify'ın Ekstra Özellikleri
n8n'i deploy ettikten sonra, Coolify'ın sağladığı ek özellikleri kullanarak sisteminizi maksimum düzeyde yönetebilirsiniz.
Monitoring
Coolify, n8n instance'ınızın kaynak tüketimini gerçek zamanlı izlemanizi sağlar:
- n8n servisinde, "Monitoring" sekmesine gidin
- Aşağıdaki metrikleri göreceksiniz:
- CPU Usage: Processor'ün yüzde kaç kullanıldığı
- Memory Usage: RAM'in yüzde kaç kullanıldığı
- Disk Usage: Depolama alanının yüzde kaç dolu olduğu
- Network: Upload/download hızı
Bu metrikler, n8n'in sağlığını kontrol etmenize ve kaynakları optimize etmenize yardımcı olur. Eğer CPU veya RAM %80'in üzerine çıkarsa, sunucu güncellemesi düşünmelisiniz.
Otomatik Yedekleme
Coolify, PostgreSQL veritabanınızı otomatik olarak yedekleyebilir. Bu, verilerinizin korunmasını sağlar:
- n8n servisinde, "Backups" sekmesine gidin
- "Enable Daily Backup" seçin
- Backup Time: Yedeklemenin yapılacağı saati seçin (örn: 02:00)
- Retention: Kaç günlük backup tutacağınızı seçin (önerilen: 30 gün)
Coolify, belirlenen saatte otomatik olarak veritabanı yedeklemesi alır. Verileriniz kaybolsa bile, yedeklemelerden geri yükleyebilirsiniz.
Webhook ve GitHub Entegrasyonu
Eğer n8n source code'unu GitHub'da depoluyorsanız, Coolify otomatik deploy özellikleri kullanabilirsiniz:
- n8n servisinde, "Webhooks" sekmesine gidin
- GitHub Repository bağlayın
- Deploy Trigger: Her push, her release vb. seçin
Böylece, GitHub'da değişiklik yapıp push ettiğiniz zaman, Coolify otomatik olarak n8n'i redeploy eder.
Multi-Server Yönetimi
Eğer birden fazla sunucunuz varsa, Coolify tümünü tek panelden yönetebilirsiniz:
- Coolify dashboard'ında, "Servers" sekmesine gidin
- "Add New Server" butonuna tıklayın
- Yeni sunucunun IP'sini ve SSH bilgilerini girin
Bundan sonra, herhangi bir sunucunuza hizmeti deploy edebilir ve tümünü merkezi olarak yönetebilirsiniz.
Sorun Giderme
n8n Coolify deployment'ında yaşanabilecek sorunlar ve çözümleri:
Sorun 1: n8n Açılmıyor (502 Bad Gateway Hatası)
Neden: n8n servisi çalışmıyor veya başlatılırken hata oluştu.
Çözüm:
- n8n servisinde, "Logs" sekmesine gidin
- Son hatayı bulun ve okuyun
- Eğer memory hatası varsa, sunucunun RAM'ini artırın
- Eğer port conflict varsa, başka bir port kullanın
- "Restart Service" butonuna tıklayın
Sorun 2: SSL Certificate Hatası
Neden: Domain DNS'i doğru şekilde yapılandırılmadı veya Let's Encrypt sertifikasını alamadı.
Çözüm:
- Domain'iniz DNS provider'ında doğru şekilde yapılandırıldığından emin olun
nslookup n8n.siteniz.comkomutunu çalıştırarak DNS'i test edin- DNS propagation'u bekleyin (24 saat kadar sürebilir)
- Coolify'da "Force Renew Certificate" butonuna tıklayın
Sorun 3: Cookie/Session Uyarısı
Neden: N8N_SECURE_COOKIE değeri yanlış ayarlandı.
Çözüm:
- Environment Variables'da,
N8N_SECURE_COOKIE=trueolduğundan emin olun - Domain başında
https://olduğundan emin olun - Eğer yine sorun yaşıyorsanız, docker-compose'u manuel düzenleyin:
PLAINTEXT
Coolify Settings → Edit Compose → Find N8N_SECURE_COOKIE → true olarak ayarla
Sorun 4: PostgreSQL Bağlantı Hatası
Neden: Veritabanı servisi başlatılamadı.
Çözüm:
- Coolify dashboard'ında, "Resources" sekmesine gidin
- PostgreSQL servisinin durunun "Running" olup olmadığını kontrol edin
- Eğer durduysa, "Start" butonuna tıklayın
- n8n'i redeploy edin
Sorun 5: High Memory/CPU Usage
Neden: n8n çok sayıda workflow çalıştırıyor veya Redis memory leaking yaşıyor.
Çözüm:
- n8n'de bitmemiş execution'ları temizleyin
- Redis cache'ini temizleyin:
redis-cli FLUSHALL - Sunucu kaynaklarını artırın
- n8n'de "Pruning" ayarlarını yapılandırın
Sonuç
Coolify ile n8n kurulumu, enterprise-grade workflow automation'ı herkesin erişebileceği bir seviyeye getirmiştir. Dakikalar içinde production-ready bir sistem oluşturabilir, otomatik yedekleme ve monitoring gibi özellikleri kullanabilirsiniz.
Bu rehberde öğrendiğiniz adımlar:
- Coolify'ı sunucunuza kurdum
- Yeni bir proje ve environment oluşturdunuz
- n8n'i one-click deploy ile deploy ettiniz
- SSL sertifikası ve domain'i yapılandırdınız
- Environment variable'ları doğru şekilde ayarladınız
- n8n instance'ına erişerek ilk hesabınızı oluşturdunuz
- Monitoring, yedekleme ve ileri özelliklerden yararlanmayı öğrendiniz
Artık kendi n8n instance'ınızda binlerce entegrasyonla workflow'lar oluşturabilir, iş süreçlerinizi otomatikleştirebilir ve onları Coolify aracılığıyla merkezi olarak yönetebilirsiniz.
İlgili Kaynaklar:
- Coolify Resmi Dokümantasyonu
- n8n Kurulumu Rehberi
- Self-Hosted Workflow Automation En İyi Uygulamaları
Coolify ve n8n kombinasyonuyla, iş otomasyonunuzun tam kontrolü sizde kalacaktır.
Sıkça Sorulan Sorular
S: Coolify nedir ve neden n8n için kullanmalıyım?
C: Coolify, açık kaynaklı bir self-hosted PaaS platformudur. n8n için one-click deploy, otomatik SSL, dahili monitoring ve yedekleme sunar. Heroku benzeri bir deneyimi kendi sunucunuzda yaşarsınız. Bu sayede, Heroku gibi ücretli platformlardan kurtulur ve verilerinizin tam kontrolünü elinizde tutarsınız.
S: Coolify ne kadar RAM kullanır?
C: Coolify kendisi yaklaşık 400 MB RAM kullanır. n8n ve PostgreSQL ile birlikte toplam 1-1.5 GB RAM tüketimi olur. Ancak workflow'lar yoğunlukla çalışıyorsa, bunun iki katı RAM gerekebilir. 2 GB RAM minimum, 4 GB önerilir, 8 GB ise ideal durumdur.
S: Coolify'da n8n'i nasıl güncellerim?
C: Coolify panelinde n8n servisinize gidin, Redeploy butonuna tıklayın. Coolify otomatik olarak en son imajı çeker ve günceller. Güncelleme öncesi otomatik yedekleme yapılandırabilirsiniz, böylece herhangi bir sorun çıksa geri dönebilirsiniz.
S: Coolify ile birden fazla n8n instance çalıştırabilir miyim?
C: Evet. Coolify'da her proje için ayrı n8n servisi deploy edebilirsiniz. Her biri kendi veritabanı ve domain'iyle bağımsız çalışır. Bu sayede, farklı departmanlar için ayrı n8n instance'ları yönetebilirsiniz.
S: Coolify ücretsiz mi?
C: Evet. Coolify tamamen açık kaynak ve ücretsizdir. Kendi sunucunuza kurarsınız ve lisans ücreti yoktur. İsteğe bağlı olarak Coolify Cloud (yönetilen hizmet) de mevcuttur, ancak kendi sunucunuzda kurulum tamamen ücretsizdir.
S: n8n'de webhook'lar düzgün çalışmıyor, ne yapmalıyım?
C: Webhooks'ların çalışması için WEBHOOK_URL doğru şekilde ayarlanmalıdır. https://n8n.siteniz.com formatında olmalı ve n8n'in erişilebildiğinden emin olmalısınız. Ayrıca, firewall veya proxy'de port 443'ün açık olduğundan emin olun.
S: Coolify ile n8n'nin scheduled workflow'larını yapılandırabilir miyim?
C: Evet. n8n'nin zamanlayıcı (scheduler) özellikleri Coolify'da da tam olarak çalışır. n8n'de workflow'lar belirli saatlerde, günlerde veya aralıklarla çalışacak şekilde yapılandırabilirsiniz.
S: Coolify'da n8n'nin credential'larını güvenli şekilde nasıl saklamalıyım?
C: n8n credential'ları PostgreSQL'de şifrelenmiş şekilde tutulur. N8N_ENCRYPTION_KEY ortam değişkeni, bu şifrelemenin anahtarıdır. Bu anahtarı güvenli şekilde saklayın ve asla değiştirmeyin (credential'ları decrypt edemezsiniz).
S: Coolify'da n8n'in LogRocket, Datadog gibi monitoring araçlarıyla entegrasyonu mümkün mü?
C: Evet. n8n'nin webhook ve API özellikleri kullanarak, herhangi bir monitoring aracıyla entegrasyon sağlayabilirsiniz. Ayrıca, Coolify'ın kendi monitoring özellikleri de yeterince kapsamlıdır.
