n8n, Docker Compose ile nasıl kurulur: SQLite yerine Postgres, .env, volume'ler ve güncellemeler adım adım.
n8n, Docker Compose ile birkaç adımda kendi sunucunuza kurulabilir: kimlik bilgilerini içeren bir compose dosyası ve bir .env dosyası oluşturursunuz, kalıcı veriler için bir volume tanımlarsınız ve stack'i tek bir komutla başlatırsınız. Üretim kullanımı için çoğu işletmeci, birlikte gelen SQLite veritabanından PostgreSQL'e geçer, çünkü aynı anda çalışan birden fazla workflow ve düzenli yedeklemeler bu şekilde daha güvenilir çalışır. Bu makale compose dosyasının yapısını, gerekli ortam değişkenlerini, volume'leri ve güncelleme sürecini gösterir. Güncelleme tarihi: Temmuz 2026.
Kurulum, n8n konteynerini başlatan bir compose.yaml dosyası ve sunucuya özel değerler için bir .env dosyası ile yapılır. Bir Linux sunucusunda önce Docker ve Docker Compose'un kurulu olup olmadığını, örneğin docker --version ve docker compose version komutlarıyla kontrol edin. Ardından compose.yaml, .env dosyası ve n8n ile host arasında dosya alışverişi için local-files alt klasörünü içeren bir proje dizini oluşturun. Başlatma docker compose up -d komutuyla yapılır, ardından n8n yapılandırılan alan adı üzerinden veya reverse proxy olmadan basit tek konteynerli bir kurulumda http://localhost:5678 adresinden erişilebilir olur. Resmi n8n dokümantasyonu bunun için hazır bir kurulum sunar: Docker Compose, ayrıca TLS sertifikaları için reverse proxy olarak Traefik'i de içerir.
n8n varsayılan olarak SQLite kullanır ve kimlik bilgilerini, workflow'ları ve çalıştırma geçmişini ek bir yapılandırma olmadan .n8n dizinindeki database.sqlite dosyasında saklar. PostgreSQL'e geçmek için compose dosyasında uygun ortam değişkenlerini, veritabanı seçimi dokümantasyonunda açıklandığı gibi ayarlayın.
Önemli: PostgreSQL kullanılsa bile /home/node/.n8n dizini için volume gereklidir, çünkü kimlik bilgileri için şifreleme anahtarı hala orada bulunur.
.env dosyası, compose.yaml'ın kendisi değişmeden kalması için sunucudan sunucuya farklılık gösteren tüm değerleri bir araya getirir. Resmi Docker kurulumu kılavuzuna göre buraya en azından aşağıdaki değişkenler ait olmalıdır.
Bu dosya parolalar ve kimlik bilgileri içerdiğinden herkese açık bir Git deposunda bulunmamalıdır.
Kalıcı bir çalışma için her yeniden başlatmada korunması gereken birkaç depolama konumu önemlidir.
Bu volume'ler olmadan, konteyner her yeniden oluşturulduğunda workflow'lar, kimlik bilgileri ve sertifikalar kaybolur.
Bir güncelleme, compose dosyasının bulunduğu dizinde üç komut üzerinden yapılır: docker compose pull yeni image sürümünü indirir, docker compose down çalışan stack'i durdurur ve docker compose up -d onu güncel image ile yeniden başlatır. Volume'ler bundan etkilenmez, böylece workflow'lar ve kimlik bilgileri korunur. En yeni kararlı sürüme otomatik olarak güncellemek yerine belirli bir sürümü sabitlemek isteyenler, compose.yaml içinde belirli bir sürüm etiketi belirtebilir; dokümantasyona göre örneğin docker.n8n.io/n8nio/n8n:1.81.0, kararsız beta sürümleri için next etiketi yerine. Baştan temiz bir yapılandırma isteyenler, sonradan sunucu sorunlarını çözmek yerine bir kez baştan sona planlamayı tercih eder. NordFlux tam olarak bunu n8n kurulumu kapsamında sabit fiyatla üstlenir; gerçek kullanıma uygun şekilde SQLite ile PostgreSQL arasında karar vermeyi de içerir.
Hayır, bu zorunlu değildir. Basit bir tek konteynerli kurulum için eşlenmiş bir volume ve 5678 portu yeterlidir, n8n bu durumda yerel olarak http://localhost:5678 üzerinden erişilebilir olur. Bir alan adı yalnızca resmi kılavuzda açıklanan, Traefik'i reverse proxy olarak ve otomatik TLS sertifikası kullanan yapıyı kullanmak istediğinizde gerekli olur.
Her şey konteyner içindeki /home/node/.n8n dizinine işaret eden bağlı volume içinde bulunur. SQLite kullanımında veritabanı dosyası orada bulunur ve veritabanı seçiminden bağımsız olarak, kaydedilmiş kimlik bilgileri için şifreleme anahtarı da orada bulunur. Bu volume olmadan, bir sonraki konteyner yeniden başlatmasında tüm veriler kaybolur.
docker compose pull, docker compose down ve docker compose up -d sırası, volume'lere dokunmadan image'ı günceller. Workflow'lar, kimlik bilgileri ve veritabanı volume'lerde bulunduğundan, güncelleme sırasında korunurlar. Büyük sürüm sıçramalarından önce yine de sürüm notlarına göz atmakta fayda vardır, çünkü ortam değişkenleri sürümler arasında değişebilir.
Evet, Docker image'ları farklı etiketlerle yayınlanır. 1.81.0 gibi belirli bir sürüm etiketi kararlı bir sürümü sabitler, next etiketi ise yeni özellikleri önceden test etmek isteyenler için kararsız beta sürümü sunar. Üretim sunucuları için sabitlenmiş bir sürüm etiketi daha güvenilir bir seçimdir.
NordFlux'un kurucusu. Webden ve SEO'dan grup ölçeğindeki otomasyona kadar yedi yıllık deneyim, bugün KOBİ'ler için pragmatik biçimde ve Alman veri egemenliğiyle.
Sertifikalar
Hetzner üzerine n8n kurmak: sunucu tipi, Caddy ile Docker Compose ve Almanya sunucu konumunun GDPR uyumlu otomasyon için neden önemli olduğu.
n8n'in Self-hosted AI Starter Kit'i, bulut API'leri olmadan yerel YZ iş akışları için Docker Compose üzerinden n8n, Ollama, Qdrant ve PostgreSQL'i başlatır.
npm, Docker veya masaustu uygulamasi: n8n'i yerel olarak nasil test edebileceginiz, kalicilik ve emek acisindan farklarin neler oldugu ve masaustu uygulamasinin neden artik var olmadigi.
SQLite yerine Postgres, düzenli bir .env dosyası ve doğru ayarlanmış volume'ler temel oluşturur, ancak gerçek güvenilirliği yalnızca güncellemeler ve yedeklemelerle sürdürülen işletim belirler. NordFlux, Docker altyapınızda geçici bakım yerine izleme, güncellemeler ve test edilmiş yedeklemelerle n8n için yönetilen işletim hizmeti sunar. İlk görüşmede mevcut kurulumunuzu inceler ve en büyük işletim risklerini gösteririz.
