n8n’i Ubuntu 24.04 Sunucusunda Çalıştırma

yazar

n8n, kod kullanmadan otomasyon tasarlayabileceğiniz esnek ve açık kaynak yapıda bir platformdur. Çok sayıda servisi basit bir şekilde birbirine bağlamanıza, uygulamayı kendi sunucunuzda çalıştırmanıza ve sınırsız otomasyon oluşturmanıza olanak sağlar.

Google Sheets, Slack, Discord, GitHub ve Notion gibi servisleri senkronize ederek günlük işlerinizi hızlandırabilir ve süreçleri daha düzenli hâle getirebilirsiniz.

Ubuntu 24.04 Üzerine n8n Nasıl Kurulur?

Başlamadan önce sisteminizi güncelleyerek kuruluma hazır hale getirelim.

sudo apt update && sudo apt upgrade -y

Ardından Docker kurulumunu yapalım. n8n farklı yöntemlerle kullanılabilse de en pratik yöntem Docker ile çalışan bir ortam kurmaktır.

sudo apt install docker.io docker-compose -y<br>sudo systemctl enable --now docker

n8n için özel bir çalışma dizini oluşturup içine geçelim.

mkdir -p ~/n8n<br>cd ~/n8n

Daha sonra port ayarları, kimlik doğrulama bilgileri ve veri yollarının tanımlanacağı Docker Compose dosyasını oluşturalım.

nano docker-compose.yml

Dosya içeriği

version: "3.1"

services:
  n8n:
    image: n8nio/n8n:latest
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=parolaniz
      - N8N_HOST=n8n.local
      - N8N_PORT=5678
    volumes:
      - ./data:/home/node/.n8n
    restart: unless-stopped

Güvenlik açısından bu bölümde yer alan parola alanını mutlaka kendi belirlediğiniz güçlü bir şifreyle değiştirmeniz gerekir.

Yapılandırma işlemi tamamlandıktan sonra n8n’i Docker üzerinden başlatabilir ve sistemin otomatik olarak bileşenleri indirmesini sağlayabilirsiniz. Servis, başlatma işlemi sonrası arka planda çalışır durumda olacaktır.

docker-compose up -d

Kurulum başarıyla tamamlandığında n8n’e tarayıcı ile erişebilirsiniz.

http://sunucu-ip-adresi:5678

Kimlik doğrulama etkinleştirildiyse giriş ekranında kullanıcı adı ile şifre talep edilir.

Kullanıcı Ayarlar

n8n arayüzünü sizden bir yönetici hesabı oluşturmanız istenir. Bu hesap, platform üzerinde tam yetkiyle işlem yapabilmenizi sağlar.

Yönetici kaydını tamamladıktan sonra ekip çalışmaları için farklı roller tanımlayabilir, kullanıcı ekleyebilir ve her kullanıcıya özel erişim izinleri verebilirsiniz.

Güvenlik Duvarı Ayarları

Sunucunuzda UFW veya başka bir firewall aktifse, HTTP ve HTTPS trafiğinin sorunsuz şekilde erişebilmesi için ilgili portların açık olması gerekir.

sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable

Güncelleme İşlemleri

n8n’i yeni sürüme yükseltmek için Docker Compose üzerinden kısa bir işlem yapmanız yeterlidir. Güncellemeden önce her zaman yedek almayı unutmayalım.

cd /opt/n8n<
sudo docker compose pull
sudo docker compose down
sudo docker compose up -d

Sık Sorulan Sorular

Güncelleme yaptıktan sonra n8n açılmıyor?

Logları kontrol ettikten sonra eksik environment değişkeni, yanlış volume yolu veya PostgreSQL bağlantı hatası soruna sebep olur. Config’i düzelttikten sonra yeniden başlatmak çoğu durumda yeterlidir.

docker compose logs n8n --tail=50

Kimlik doğrulama ekranı gelmiyor, şifre sormadan açılıyor. Neden?

N8N_BASIC_AUTH_ACTIVE değişkeninin yanlış yazıldığı durumlarda kimlik doğrulama çalışmaz.

Doğru yapı şu şekildedir.

N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=parola

n8n reverse proxy’de 504 Gateway Timeout hatası alıyorum?

n8n uzun süren workflow çalıştırdığında veya proxy’nin timeout süresi düşük ayarlandığında 504 Gateway Timeout hatası ortaya çıkar. 

proxy_read_timeout 300;
proxy_connect_timeout 60;
proxy_send_timeout 300;

504 hatasının nedenlerini ve ek çözüm seçeneklerini görmek için şu rehbere bakabilirsiniz.

504 Gateway Timeout Hatası Nasıl Çözülür?

Yorum yapın