n8n'i bir VPS üzerinde kendi sunucunuzda barındırın.
Sizin otomasyon motorunuz, sizin kimlik bilgileriniz, sizin donanımınız.

n8n bir iş akışı otomasyon motorudur: bir tetikleyiciyi — bir webhook, bir zamanlama, bir veritabanındaki yeni bir satır, bir kuyruktaki bir mesaj — API'leri çağıran, veriyi dönüştüren, koşullara göre dallanan, keyfi JavaScript veya Python çalıştıran ve sonucu bir sonraki adıma teslim eden bir düğüm zincirine bağladığınız görsel bir tuval. Kutuda birkaç yüz entegrasyon düğümü gelir, artı geri kalan her şeyi kapsayan genel bir HTTP Request düğümü. 1.x serisinden beri AI Agent ve LLM düğümlerini de taşır, bu yüzden 2026'da onu kuran kişilerin büyük bir bölümü klasik ETL boru hattı yerine ajan inşa ediyor.

Tek bir komut yazmadan önce önemli olan kısım lisanstır, çünkü n8n OSI anlamında açık kaynak değildir ve bu fark akademik değildir. Çekirdek, Sustainable Use License altında dağıtılır: yazılımı iç iş amaçları için ve kişisel veya ticari olmayan kullanım için kullanma, kopyalama, değiştirme ve dağıtma hakkında münhasır olmayan, telifsiz, dünya çapında bir hak. Alıkoyduğu şey, n8n'i veya türevini başkalarına ücret karşılığı sunma hakkıdır — bu da bunun üzerine ücretli bir "managed n8n" ürünü kurmayı devre dışı bırakan maddedir. Ayrı olarak, adında .ee. veya yolunda .ee taşıyan herhangi bir dosya bu lisansın tamamen dışında tutulur ve ücretli bir n8n Enterprise License gerektirir.

Açıkça okuyun: n8n'i bir VPS üzerinde kendi şirketinizi, sunduğunuz bir hizmet olarak teslim ettiğiniz kendi müşterilerinizin işini veya kendi kişisel hayatınızı otomatikleştirmek için çalıştırmak, ücretsiz hakkın içindedir ve her zaman öyle olmuştur. n8n'i barındırma ürünü olarak satmak ise değildir. İnternetteki neredeyse her "n8n gerçekten ücretsiz mi?" tartışması, bu çizginin iki yakasında birbirini duymayan iki kişinin konuşmasıdır.

Maliyet tarafı. n8n Cloud, yürütme başına fiyatlandırılır: Starter planı 2,500 yürütme için yıllık faturalandırmayla ayda €20, Pro 10,000 için ayda €50, Business 40,000 için ayda €667. Kendi barındırılan durumda, yürütme sayısı kesinlikle bir kalem değildir — kutunun ne kadar CPU ve belleğe sahip olduğuyla sınırlanır. Bir API'yi beş dakikada bir yoklayan bir iş akışı, tek başına ayda 8,640 yürütme harcar; Cloud'da bu tek iş akışı zaten Pro katmanını zorunlu kılar, $3.90'lık bir VPS'te ise boşta CPU'ya karşı bir yuvarlama hatasıdır.

Ağustos 2026'da n8n.io'da yayımlanan Cloud fiyatları, yıllık faturalandırmayla; aylık faturalandırma daha pahalıya gelir. Buradaki alışveriş yalnızca para değil — kendi barındırma, güncellemeleri, yedeklemeleri, TLS yenilemesini ve çalışma süresini hattın sizin tarafınıza taşır.

Panelde: Order → VPS → Sentinel, imaj Debian 12. Hesap açmak için e-posta adresi gerekmez, hiçbir aşamada kimlik belgesi istenmez ve fatura Monero, Bitcoin, Lightning veya diğer desteklenen varlıklardan biriyle ödenir. Kaleyi kendinize olan gecikmeye göre değil, otomatikleştirdiğiniz hizmetlere olan gecikmeye göre seçin — bir otomasyon sunucusu sizinle konuştuğundan çok daha fazla API'lerle konuşur.

Sonra sunucuya dokunmadan önce DNS kaydını oluşturun: VPS'in IPv4'üne işaret eden n8n.example.com için bir A kaydı ve IPv6 kullanıyorsanız bir AAAA kaydı. Bu önce yapılmalı, çünkü Caddy yığın başlar başlamaz Let's Encrypt'ten bir sertifika ister ve çözümlenmeyen bir ad için sertifika isteği başarısız olur — sonra geri çekilir ve sitenin neden erişilemez olduğunu merak ederek yirmi dakika harcarsınız.

Devam etmeden önce DNS'in yayılması için bir dakika bekleyin ve kendi makinenizden doğrulayın:

dig +short n8n.example.com
# → the IPv4 of your VPS, and nothing else

Herhangi bir şey herkese açık bir bağlantı noktasını dinlemeye başlamadan önce ilk saat güçlendirme kontrol listesini uygulayın — yalnızca anahtarla SSH, sadece 22, 80 ve 443'e izin veren bir güvenlik duvarı ve gözetimsiz güvenlik güncellemeleri. Bir otomasyon sunucusu bir kimlik bilgisi kasasıdır; o tam saati hak eder.

Önce dizini oluşturun ve iki gizli değeri üretin. Bunları şimdi, bu sırayla üretin ve üretirken .env dosyasına yapıştırın — özellikle şifreleme anahtarı, n8n'in ilk açılışından önce var olmalı, sonra değil.

mkdir -p /opt/n8n && cd /opt/n8n
openssl rand -hex 32   # → N8N_ENCRYPTION_KEY
openssl rand -hex 24   # → POSTGRES_PASSWORD

/opt/n8n/.env

DOMAIN=n8n.example.com
LETSENCRYPT_EMAIL=you@example.com
GENERIC_TIMEZONE=Europe/Stockholm

N8N_ENCRYPTION_KEY=paste_the_32_byte_hex_here
POSTGRES_DB=n8n
POSTGRES_USER=n8n
POSTGRES_PASSWORD=paste_the_24_byte_hex_here

Dosyayı hemen kilitleyin — örneğin bugüne kadar ve bundan sonra saklayacağı her kimlik bilgisinin anahtarını taşır:

chmod 600 /opt/n8n/.env

/opt/n8n/docker-compose.yml

services:
  caddy:
    image: caddy:2-alpine
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    environment:
      - DOMAIN=${DOMAIN}
      - LETSENCRYPT_EMAIL=${LETSENCRYPT_EMAIL}
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      - POSTGRES_DB=${POSTGRES_DB}
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    volumes:
      - pg_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 10

  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      - N8N_HOST=${DOMAIN}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - N8N_EDITOR_BASE_URL=https://${DOMAIN}
      - WEBHOOK_URL=https://${DOMAIN}/
      - N8N_PROXY_HOPS=1
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
      - N8N_BLOCK_ENV_ACCESS_IN_NODE=true
      - N8N_DIAGNOSTICS_ENABLED=false
      - N8N_VERSION_NOTIFICATIONS_ENABLED=false
      - N8N_PERSONALIZATION_ENABLED=false
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  caddy_data:
  caddy_config:
  pg_data:
  n8n_data:

/opt/n8n/Caddyfile

{$DOMAIN} {
    encode zstd gzip
    tls {$LETSENCRYPT_EMAIL}
    reverse_proxy n8n:5678
}

Adını anmaya değer iki tasarım kararı. İlk olarak, n8n bir bağlantı noktası yayımlamaz. Yalnızca Caddy 80 ve 443'ü bağlar; n8n, Compose ağı içinde 5678'i dinler ve host dışından hiçbir şey ona erişemez. Şaşırtıcı sayıda kendi barındırılan n8n örneği, önünde TLS olmadan 5678 bağlantı noktasında herkese açık internette durur ve açığa çıkmış hizmetler için arama motorları bunları indeksler. İkincisi, iş akışlarını artık PostgreSQL tutuyor olsa da n8n veri birimi bağlı kalır — o dizin hâlâ örnek ayarlarını, günlük dosyalarını ve kaynak kontrolü varlıklarını taşır.

Ayağa kaldırın:

cd /opt/n8n
docker compose up -d
docker compose logs -f caddy   # watch the certificate being issued

Açılan, düzenleyiciyi gösteren ve manuel bir testi çalıştıran bir n8n, henüz çalışan bir n8n değildir. Sessizce bozulan yarı ise gelen webhook'lardır ve bu bozulma, hata sanki üçüncü taraf hizmetteymiş gibi görünen biçimlerde gerçekleşir.

WEBHOOK_URL. Bu olmadan, n8n webhook URL'lerini N8N_HOST ve N8N_PORT'tan oluşturur ve size http://localhost:5678/webhook/abc gibi bir şey verir — bunu da Stripe veya GitHub'a yapıştırırsınız, orada asla erişilemez. Yukarıdaki Compose dosyası WEBHOOK_URL'i herkese açık HTTPS köküne ayarlar, ki düzenleyicinin göstereceği ve dış dünyanın gerçekten çağırabileceği şey de budur.

N8N_EDITOR_BASE_URL. n8n'in gönderdiği e-postalardaki bağlantılar için kullandığı herkese açık URL — parola sıfırlamaları, kullanıcı davetleri. Burada yanlış olması, localhost'a işaret eden bir davet bağlantısı demektir; bu da bozuk bir entegrasyondan çok bir meslektaştan gelen destek talebidir.

N8N_PROXY_HOPS. n8n istemci IP'sini X-Forwarded-For'dan okur ve yalnızca bu sayının belirttiği kadar sıçramaya güvenir. Önde tek bir ters proxy ile — bu yığındaki Caddy — değer 1'dir. Caddy'nin önüne Cloudflare koyun, 2 olur. Varsayılan 0'da bırakın, her istek proxy'nin kendisinden geliyormuş gibi görünür, ki bu da sessizce hız sınırlarını ve iş akışlarınızdaki herhangi bir IP tabanlı mantığı bozar.

N8N_SECURE_COOKIE. Varsayılan olarak true'dur, yani oturum çerezi yalnızca HTTPS üzerinden gönderilir. Bu doğru ayardır ve bu yığın bunu karşılar. Bunu bilmek işe yarar çünkü düz http üzerinden yapılan ilk denemenin klasik belirtisini açıklar: giriş formu parolayı kabul eder ve sizi sonsuza dek giriş formuna geri döndürür. Çözüm TLS'tir, bayrağı kapatmak değil.

Düzgün test edin. Bir Webhook düğümüyle bir iş akışı oluşturun, iş akışını etkinleştirin, Production URL'sini kopyalayın, ardından sunucu olmayan bir makineden çağırın:

curl -i https://n8n.example.com/webhook/<path>
# → HTTP/2 200, and a new execution visible in the editor

Herkesin bir kez takıldığı ayrım: Test URL'si yalnızca düzenleyiciyi "Listen for test event" etkinleştirilmiş şekilde açık tuttuğunuz sürece dinler. Production URL'si yalnızca iş akışı Active'e çevrildiğinde var olur. Düzenleyicide çalışan ve üretimde 404 veren bir webhook, neredeyse her zaman etkin olmayan bir iş akışıdır.

n8n varsayılan olarak normal modda çalışır: düzenleyiciyi sunan ve webhook'ları alan aynı süreç, iş akışlarını da yürütür. Bu basittir ve uzun bir iş akışı diğerlerini beklemeye başlayana kadar da doğrudur. Belirti yanılmaz — yürütmeler dakikalarca "running" durumunda kalır, düzenleyici ağırlaşır ve 200 ms içinde yanıt vermesi gereken bir webhook sekiz saniyede yanıt verir.

Kuyruk modu işi böler. Ana örnek düzenleyiciyi, tetikleyicileri ve webhook uç noktalarını elinde tutar; yürütme kimliklerini Redis'e iter; ayrı worker süreçleri bunları çeker, iş akışını PostgreSQL'den yükler, çalıştırır ve Redis üzerinden geri bildirir. Bu mimariden üç kural çıkar ve üçü de onları atlayanları ısırır: her örnek aynı PostgreSQL veritabanını paylaşmalı, her örnek aynı N8N_ENCRYPTION_KEY'i taşımalı ve SQLite hiçbir şekilde desteklenmez.

Compose dosyasına eklenenler bir Redis servisi ve worker komutuyla çalıştırılan aynı n8n imajı olan bir worker servisidir:

  redis:
    image: redis:7-alpine
    restart: unless-stopped
    command: ["redis-server", "--save", "60", "1", "--appendonly", "no"]
    volumes:
      - redis_data:/data

  n8n-worker:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    command: worker --concurrency=5
    depends_on:
      - redis
      - postgres
    environment:
      # the SAME encryption key and the SAME database as the main instance
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}

EXECUTIONS_MODE=queue ve QUEUE_BULL_REDIS_HOST=redis değerlerini ana n8n servisine de ekleyin — her iki taraf da mod konusunda hemfikir olmalı. İlk günden ayarlanması gereken iki seçenek var: düzenleyicide "Test workflow" tuşuna basmanın ana süreci meşgul etmemesi için OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true, ve varsayılan olarak 30 saniye olan, bir worker'ın yeniden dağıtım sırasında mevcut işini bitirmesine ne kadar süre tanınacağını belirleyen N8N_GRACEFUL_SHUTDOWN_TIMEOUT. Workflow'larınız genellikle yarım dakikadan uzun sürüyorsa bu değeri artırın, aksi halde her dağıtım devam eden işi öldürür.

Buradan başlamayın. Kuyruk modu iki hareketli parça ve normal modun kesinlikle sahip olmadığı bir hata sınıfı ekler. Kuyruğun büyüdüğünü veya bir iş akışının diğerini engellediğini görene kadar normal modda kalın, sonra ikinci bir kutu eklemeden önce aynı kutuya tek bir worker ekleyin. Bu ilerleme — normal modda Sentinel, tek worker'lı Garrison, üç worker'lı Ravelin — gerçekten büyük bir dağıtım dışında her şeyi kapsar.