Sıfırdan Başlayanlar İçin n8n Kurulum Rehberi

Otomasyon, iş hayatımızda manuel ve tekrarlayan görevleri yapay zeka ve entegrasyonlarla otomatikleştirmenin anahtarı haline geldi. Bu rehberde, popüler otomasyon aracı n8n'i kendi sunucunuzda nasıl kurabileceğinizi sıfırdan adım adım anlatıyoruz.

1. n8n Nedir? Neden Seçmeliyiz?

n8n (nodemation), farklı servisleri (API'leri, araçları ve veri tabanlarını) birbirine bağlamanızı sağlayan ücretsiz ve açık kaynak kaynaklı (fair-code) bir workflow (iş akışı) otomasyon aracıdır. Diğer bulut otomasyon platformlarına kıyasla n8n, verilerinizin kendi sunucunuzda kalmasını sağlar ve sayısız node içerir. Ayrıca webhooklar ve arayüz üzerinden görsel programlama yeteneği onu mükemmel bir tercih yapar.

2. Kurulum Öncesi Gereksinimler

Kuruluma başlamadan önce elinizde şunların bulunması önemlidir:

• Bir Sunucu (VPS) veya Yerel Bilgisayar: İşlemlerin arka planda sürekli çalışmasını istiyorsanız bir bulut sunucu (DigitalOcean, AWS, vb.) tercih edebilirsiniz.
• Node.js veya Docker: Biz bu rehberde en güvenilir ve yalıtılmış yöntem olan Docker kurulumunu tercih edeceğiz. Sunucunuzda Docker ve Docker Compose'un yüklü olduğundan emin olun.

3. Docker Compose ile n8n Kurulumu

Kurulum için bir docker-compose.yml dosyası oluşturacağız. Terminalinizde n8n'i barındırmak istediğiniz klasörü açın ve aşağıdaki yapılandırmayı .yml dosyanızın içine yapıştırın:

version: '3.8'

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - WEBHOOK_URL=http://localhost:5678/
      - GENERIC_TIMEZONE=Europe/Istanbul
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

Eğer domain kullanmak veya dışarı açmak istiyorsanız N8N_HOST ve WEBHOOK_URL değerlerini kendi sunucu adınıza veya alan adınıza göre düzenleyebilirsiniz.

Sistemi ayağa kaldırmak için terminalde şu komutu çalıştırın:

docker compose up -d

Docker gerekli imajı indirecek ve arkaplanda çalıştıracaktır.

4. İlk Giriş ve Kurulum Sekansı

Tarayıcınızı açın ve http://sunucu_ip_adresiniz:5678 adresine gidin. n8n arayüzü karşınıza geldiğinde sizden bir yönetici (Owner) hesabı oluşturmanızı isteyecektir. Burada email ve şifrenizi belirleyerek ilk giriş işleminizi tamamlayın. Bu bilgiler n8n kontrol panelinize bir sonraki erişim işleminizde kullanılacaktır.

5. Dışarıya Açma

Eğer n8n'i lokal bilgisayarınız dışında web'e doğrudan açmak istiyorsanız, bir ters vekil sunucusu (Reverse Proxy) kullanmanız gerekmektedir. Nginx Proxy Manager, Traefik ya da Cloudflare Tunnels çok sık kullanılan yöntemlerdir. Bunlar, HTTP isteklerini n8n'e güvenli olarak ulaştırıp SSL (HTTPS) sertifikası tahsis etmenize olanak tanır.

6. Sonraki Adım: Antigravity ile Orkestrasyon

Artık n8n sunucunuz olduğuna göre otomasyonları inşa etmeye başlayabilirsiniz. Ancak "Acaba iş akışlarını tasarlamak yerine bir yapay zekaya çizdirebilir miyim?" diye düşünüyorsanız, bir sonraki yazımız olan İleri Seviye: Antigravity ile n8n Orkestrasyonu rehberimize mutlaka göz atın.