Dokploy ile n8n Kurulumu: Hafif ve Hızlı Self-Hosted Çözüm

n8n, iş otomasyonu için güçlü bir açık kaynak platformudur. Ancak n8n'i kendi sunucunuzda çalıştırmak karmaşık Docker konfigürasyonları gerektire bilir. Dokploy ile bu işlem çok daha basit hale gelir. Dokploy, 26.000+ GitHub yıldızıyla açık kaynaklı bir self-hosted PaaS (Platform as a Service) çözümüdür ve n8n Dokploy kurulumu için hazır template'ler sunar.

Bu rehberde, Dokploy'un minimum kaynak gereksinimleriyle (yaklaşık 250 MB RAM) n8n'i nasıl kuracağınızı, yapılandıracağınızı ve çalıştıracağınızı adım adım öğreneceksiniz. Hem template modunu hem de Docker Compose modunu ele alarak, production ortamınız için hazır bir kurulum sağlayacağız.

İçindekiler

• Dokploy Nedir?
• 1. Adım: Dokploy Kurulumu
• 2. Adım: Yeni Proje Oluşturma
• 3. Adım: n8n Deploy (2 Yöntem)
• 4. Adım: Domain ve SSL Yapılandırması
• 5. Adım: Environment Variables
• 6. Adım: Deploy ve Erişim
• Sorun Giderme
• Sonuç
• Sıkça Sorulan Sorular

Dokploy Nedir?

Dokploy, başarısının birinci sebebi ağırlık ve karmaşıklığı minimalize etmesidir. Coolify ve CapRover gibi alternatif PaaS çözümleriyle karşılaştırıldığında, Dokploy yalnızca 250 MB RAM kullanarak çalışır ve bu onu tercih edilen bir seçim yapar.

Dokploy'un temel özellikleri şunlardır:

• Açık Kaynaklı: Tamamen ücretsiz ve GitHub'da kaynak kodları mevcuttur
• Düşük Sistem Gereksinimleri: Yaklaşık 250 MB RAM ile çalışır
• Docker Entegrasyonu: Docker ve Docker Compose uygulamalarını GUI üzerinden yönetmenizi sağlar
• Hazır Template'ler: n8n, WordPress, Strapi, Ghost gibi popüler uygulamaların template'leri mevcuttur
• Let's Encrypt SSL: Otomatik SSL sertifikaları oluşturur ve yönetir
• Kullanıcı Dostu Interface: Web tabanlı panelinde tüm işlemleri gerçekleştirebilirsiniz

Dokploy, özellikle ufak ve orta ölçekli işletmeler, yazılımcılar ve self-hosted çözüm arayanlar için ideal bir seçimdir. n8n kurulumunun template üzerinden yapılması, karmaşık konfigürasyonların sizin için otomatik olarak ayarlanacağı anlamına gelir.

1. Adım: Dokploy Kurulumu

Dokploy'u kurmak oldukça basittir. Sunucunuza SSH ile bağlandıktan sonra aşağıdaki komutu çalıştırın:

curl -sSL https://dokploy.com/install.sh | sh

Bu komut otomatik olarak Docker'ı kontrol eder, gerekli bileşenleri indirir ve Dokploy daemon'ını başlatır. Kurulum işlemi genellikle 1-2 dakika içinde tamamlanır.

Kurulum başarıyla tamamlandığında, web tarayıcınızda http://SUNUCU_IP:3000 adresine erişebilirsiniz. İlk giriş yaptığınızda, bir admin hesabı oluşturmalısınız. E-mail adresinizi ve güçlü bir şifre belirledikten sonra Dokploy paneline giriş yapabilirsiniz. Panelde tüm sunucu kaynaklarınızı, container'larınızı ve uygulamalarınızı yönetebileceğiniz bir dashboard bulacaksınız.

2. Adım: Yeni Proje Oluşturma

Dokploy paneline giriş yaptıktan sonra yeni bir proje oluşturmalısınız. Sol menüden "Projects" seçeneğini tıklayıp "New Project" butonuna tıklayarak yeni bir proje başlatın. Projenize bir isim verin; örneğin "n8n-Automation" gibi açıklayıcı bir ad seçebilirsiniz.

Proje oluşturduktan sonra, bu proje altında servislerinizi (container'larınızı) organize edeceksiniz. Dokploy, her proje için ayrı bir Docker network oluşturarak projeler arasında izolasyon sağlar. Proje oluşturulduktan sonra, proje detay sayfasında "Services" sekmesine erişim sağlayarak n8n deployment işlemini başlatabilirsiniz.

3. Adım: n8n Deploy (2 Yöntem)

n8n'i Dokploy ile deploy etmenin iki ana yöntemi vardır. İlk yöntem hızlı ve önerilir, ikinci yöntem ise daha fazla kontrol ve özelleştirme sunar.

Yöntem A: Template ile Deploy (Önerilen)

Dokploy'un n8n template'i, production ortamında ihtiyacınız olan tüm bileşenleri içerir. Template ile deploy etmek en hızlı ve en güvenli yöntemdir.

Adımlar:

1. Dokploy panelinde ilgili projenize gidin
2. "Services" sekmesini açın ve "New Service" butonuna tıklayın
3. "Templates" seçeneğini seçerek template listesini görmek için arama yapın veya sayfada n8n'i bulun
4. n8n template'ini seçin

Dokploy'un n8n template'i aşağıdaki bileşenleri otomatik olarak yapılandırır:

• n8n Ana Instance: Web arayüzü ve workflow engine'i çalıştıran ana uygulama
• Worker: Ağır işleri işlemek için ek worker container'ları
• Runner: Webhook ve long-running workflows'lar için
• Redis: Cache ve session yönetimi için
• PostgreSQL: Veritabanı olarak kullanılır
• Ollama (İsteğe Bağlı): Yerel AI modellerini çalıştırmak için

Template'i seçtikten sonra, Dokploy otomatik olarak bu bileşenleri kurmak için gerekli environment variable'ları sorar. Çoğu değer zaten önceden doldurulmuş haldedir.

Yöntem B: Docker Compose Modu

Daha fazla kontrol ve özelleştirme istiyorsanız, Docker Compose modu kullanabilirsiniz. Bu yöntemde kendi docker-compose.yml dosyanızı Dokploy'a yüklüyorsunuz.

Adımlar:

1. Dokploy panelinde "Services" sekmesinden "New Service" butonuna tıklayın
2. "Docker Compose" seçeneğini seçin
3. Aşağıdaki örnek docker-compose.yml içeriğini kopyalayıp yapıştırın:

version: '3.8'
 
services:
  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: ${DB_NAME:-n8n}
      POSTGRES_USER: ${DB_USER:-n8n}
      POSTGRES_PASSWORD: ${DB_PASSWORD:-changeme}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ['CMD-SHELL', 'pg_isready -U ${DB_USER:-n8n}']
      interval: 10s
      timeout: 5s
      retries: 5
 
  redis:
    image: redis:7-alpine
    healthcheck:
      test: ['CMD', 'redis-cli', 'ping']
      interval: 10s
      timeout: 5s
      retries: 5
 
  n8n:
    image: n8nio/n8n:latest
    restart: always
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${DB_NAME:-n8n}
      - DB_POSTGRESDB_USER=${DB_USER:-n8n}
      - DB_POSTGRESDB_PASSWORD=${DB_PASSWORD:-changeme}
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - N8N_HOST=${N8N_HOST:-localhost}
      - N8N_PROTOCOL=${N8N_PROTOCOL:-http}
      - WEBHOOK_URL=${WEBHOOK_URL:-http://localhost}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE:-UTC}
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    ports:
      - "5678:5678"
 
volumes:
  postgres_data:
  n8n_data:

Docker Compose modunda, Dokploy external: true olarak network ayarlarını kendisi yönetir. Bu sayede multiple container'lar arasında sorunsuz iletişim sağlar. Compose dosyasında tanımlanan her service, Dokploy tarafından ayrı container'lar olarak ayağa kaldırılır.

4. Adım: Domain ve SSL Yapılandırması

Production ortamında n8n'e HTTPS üzerinden erişmelisiniz. Dokploy, Let's Encrypt ile otomatik SSL sertifikaları oluşturur ve yönetir.

Adımlar:

1. Dokploy panelinde n8n servisinize gidin
2. "Domains" sekmesini açın
3. "Add Domain" butonuna tıklayın ve domain adınızı yazın (örneğin: n8n.siteniz.com)
4. DNS sağlayıcınızda bu domain için bir A kaydı oluşturun ve sunucunuzun IP adresine yönlendirin
5. Dokploy otomatik olarak Let's Encrypt sertifikasını oluşturacak ve HTTPS'i yapılandıracaktır

DNS A kaydı ayarlandıktan sonra, Dokploy arka planda sertifika validation işlemini gerçekleştirir. Bu işlem genellikle 5-10 dakika içinde tamamlanır. Domain ayarlaması tamamlandıktan sonra, tarayıcınızda https://n8n.siteniz.com adresine erişerek n8n'in güvenli bir bağlantı üzerinden çalıştığını görebilirsiniz. Daha fazla bilgi için Dokploy resmi sitesini ziyaret edin.

5. Adım: Environment Variables

n8n'in doğru şekilde çalışması için çeşitli environment variable'larını ayarlamalısınız. Bu değişkenler n8n'nin davranışını kontrol eder ve önemli ayarları belirler.

Dokploy panelinde n8n servisinizin "Settings" sekmesinden bu değişkenleri yönetebilirsiniz. Aşağıdaki temel environment variable'ları ayarlamanızı önerilir:

N8N_HOST=n8n.siteniz.com
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.siteniz.com
GENERIC_TIMEZONE=Europe/Istanbul
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=postgres
DB_POSTGRESDB_USER=n8n
DB_POSTGRESDB_PASSWORD=guclu_sifre_buraya
REDIS_HOST=redis
N8N_EDITOR_BASEURL=https://n8n.siteniz.com/

• N8N_HOST: n8n'in barındırılacağı domain adı
• N8N_PROTOCOL: HTTP veya HTTPS protokolü (production'da HTTPS kullanın)
• WEBHOOK_URL: Webhook'lar için temel URL
• GENERIC_TIMEZONE: Türkiye için Europe/Istanbul seçiniz
• DB_ değişkenleri*: PostgreSQL bağlantı bilgileri
• REDIS_HOST: Redis server'ının host adresi

Template modu kullanıyorsanız, bu değişkenlerin çoğu zaten önceden ayarlanmıştır. Sadece domain ve protocol değerlerini güncelleyebilirsiniz.

6. Adım: Deploy ve Erişim

Tüm ayarlamaları tamamladıktan sonra, n8n'i deploy etmeye hazırsınız. Dokploy panelinde n8n servisinizde "Deploy" butonuna tıklayın.

Deploy işlemi başladıktan sonra, Dokploy Docker imajlarını indirir, container'ları oluşturur ve başlatır. Bu işlem, internet hızınıza ve sunucu performansına bağlı olarak 2-10 dakika arasında sürebilir. Build loglarını takip ederek deployment sırasında olası sorunları görebilir ve çözebilirsiniz.

Deploy işlemi başarıyla tamamlandıktan sonra, tarayıcınızda https://n8n.siteniz.com adresine gidin. n8n login ekranını gördüğünüzde, kurulum başarılı demektir. İlk kez giriş yapacaksanız, n8n size admin hesabı oluşturmak için sorular soracaktır.

Giriş yaptıktan sonra, n8n dashboard'unda yeni workflow'lar oluşturabileceğiniz main editor ekranını göreceksiniz. Workflow oluşturarak, çeşitli uygulamaları entegre edebilir, otomasyonlar yapabilirsiniz.

Sorun Giderme

n8n ve Dokploy kurulumunda karşılaşılan yaygın sorunların çözümleri burada yer almaktadır.

Sorun 1: Domain DNS Ayarlaması Çalışmıyor

Eğer domain adresinize erişemiyorsanız, DNS ayarlarını kontrol edin. Dokploy panelinde "Settings" sekmesinde sunucunuzun IP adresini bulun ve bu IP'ye domain için bir A kaydı yönlendirdiğinizden emin olun. DNS değişiklikleri 24 saate kadar yayılmakta olabilir.

Sorun 2: SSL Sertifikası Oluşturulamıyor

Let's Encrypt sertifikası oluşturmak için, domain'in sunucunuzun IP adresine yönlendirilmiş olması gerekir. Sertifika oluşturulmamışsa, server loglarını kontrol ederek hatayı görebilirsiniz. Dokploy panelinde "Monitoring" sekmesinden logları izleyebilirsiniz. Dokploy sitesinden sorun giderme kılavuzundan yararlanabilirsiniz.

Sorun 3: n8n Container'ı Başlamıyor

Container başlamıyorsa, environment variable'larında eksik veya yanlış değer olabilir. Dokploy panelinde servisinizin loglarını kontrol edin. PostgreSQL ve Redis container'larının sağlıklı çalıştığını doğrulayın.

Sorun 4: Veritabanı Bağlantı Hatası

PostgreSQL bağlantı bilgilerinin doğru olduğundan emin olun. Container'lar arasında iletişimin sağlanması için, Docker Compose yapılandırmasında service isimleri doğru yazıldığını kontrol edin. Redis ve PostgreSQL container'larının sağlık kontrolleri başarılı olmalıdır.

Sorun 5: Workflow Executor Çalışmıyor

Workflow'lar çalışmıyorsa, Runner ve Worker container'larının sağlıklı olduğundan emin olun. Dokploy panelinde "Services" sekmesinde tüm container'ları kontrol ederek, hepsi running durumda olup olmadığını görebilirsiniz.

Sonuç

Dokploy ile n8n kurulumu, traditional yöntemlere kıyasla çok daha basit ve hızlıdır. Dokploy'un hafif yapısı (250 MB RAM) ve hazır template'leri sayesinde, production ortamında çalışan n8n instance'ı dakikalar içinde ayağa kaldırabilirsiniz.

Bu rehberde öğrendiklerinizi özetlemek gerekirse:

• Dokploy kurulumu tek bir komutla yapılır
• Template modu hızlı deployment için idealdir
• Docker Compose modu daha fazla kontrol sağlar
• Domain ve SSL otomatik olarak Let's Encrypt ile yönetilir
• Environment variable'lar n8n davranışını belirler
• Sorun giderme Dokploy logları üzerinden yapılır

n8n kurulumunuz tamamlandıktan sonra, n8n kurulumu rehberimize göz atarak workflow oluşturma ve integration setup ile ilgili daha detaylı bilgiler edinebilirsiniz.

Dokploy ve n8n kombinasyonu, hafif kaynaklar ile güçlü bir otomasyon platformu sunar. Self-hosted çözüm arayanlar için, bu kombinasyon maliyet-etkinlik açısından en iyi seçimlerden biridir.

Sıkça Sorulan Sorular

S: Dokploy nedir?

C: Dokploy, 26.000+ GitHub yıldızına sahip açık kaynaklı bir self-hosted PaaS platformudur. Docker ve Docker Compose uygulamalarını GUI üzerinden yönetmenizi sağlar. Coolify ve CapRover gibi alternatiflerden daha hafif bir seçenek sunar.

S: Dokploy ne kadar kaynak kullanır?

C: Dokploy yaklaşık 250 MB RAM kullanır. Bu onu Coolify ve CapRover'a göre daha hafif bir seçenek yapar. n8n eklendiğinde, total RAM kullanımı instance konfigürasyonuna bağlı olarak 1-2 GB arasında olabilir.

S: Dokploy'da n8n template'i ne içerir?

C: Dokploy'un n8n template'i n8n ana instance, Worker, Runner, Redis, PostgreSQL ve isteğe bağlı Ollama AI model yapılandırmasını içerir. Bu bileşenlerin tümü, production ortamında n8n'i çalıştırmak için gerekli olan minimum kurulum sağlar.

S: Dokploy'u kaldırmak mümkün mü?

C: Evet. dokploy uninstall komutu ile Dokploy'u sistemden tamamen kaldırabilirsiniz. Ancak bu işlem tüm container'ları ve volume'leri silecek, verileriniz kaybolacağı için öncesinde yedek almayı unutmayın.

S: Dokploy'da multiple n8n instance çalıştırabilir miyim?

C: Evet. Farklı projelerde veya aynı projede multiple n8n instance'ı çalıştırabilirsiziz. Her biri ayrı veritabanı ve port yapılandırmasına sahip olabilir.

S: Dokploy ile n8n'i nasıl güncellerim?

C: Dokploy panelinde n8n servisinize gidin ve Redeploy butonuna tıklayın. Dokploy en son Docker imajını çekerek güncelleme yapar. Veritabanınız ve workflow'larınız korunur, sadece application sürümü güncellenir.

S: SSL sertifikası için ek ücret var mı?

C: Hayır. Dokploy, Let's Encrypt kullanarak otomatik SSL sertifikaları oluşturur ve bu tamamen ücretsizdir. Sertifikalar her 90 gün otomatik olarak yenilenir.

S: Dokploy'da data backup nasıl yapılır?

C: Dokploy, container volume'lerini yönetir. PostgreSQL ve n8n data'sını backup etmek için, docker exec komutu ile container'a erişerek veya volume'leri direktly yedekleyerek backup oluşturabilirsiniz. Dokploy panelinde bulunan backup özellikleri mevcutsa, bunları kullanmanız önerilir.

S: Dokploy ile n8n'de SMTP yapılandırması yapabilir miyim?

C: Evet. n8n'in environment variable'larında SMTP ayarlarını belirtebilirsiniz. Dokploy panelinde Environment Variables sekmesinde SMTP_ ile başlayan değişkenleri ekleyerek SMTP yapılandırmasını tamamlayabilirsiniz.

S: Worker ve Runner'lar ne için kullanılır?

C: Worker'lar, ağır işleme gerektiren workflow'ları işlemek için kullanılır. Runner'lar ise webhook tetiklemesi ve long-running workflow'lar için tasarlanmıştır. Bu bileşenler n8n'in scalability'sini sağlar.