Ubuntu 24.04 Ortamında n8n İçin Kurulumu

yazar

n8n, kullanıcıların kod yazmadan otomasyon akışları oluşturmasını sağlayan açık kaynak bir araçtır. Farklı servislerle kolay entegrasyon imkânı sunar, kendi sunucunuzda çalışabilir ve sınırsız sayıda workflow hazırlamanıza izin verir.

Google Sheets, Slack, Discord, GitHub ve Notion gibi uygulamaları bir araya getirerek operasyonlarınızı daha hızlı yönetebilir ve süreçlerinizi daha organize bir düzene taşıyabilirsiniz.

Ubuntu 24.04 Üzerine n8n Nasıl Kurulur?

Kuruluma başlamadan önce sistemdeki paketleri güncellemek sağlıklı bir başlangıç olacaktır.

sudo apt update && sudo apt upgrade -y

Sonrasında Docker kurulumu yapılmalıdır. n8n birçok yöntemle çalıştırılabilir, fakat en sorunsuz ve kararlı sonuç Docker ile elde edilir.

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

Şimdi n8n için kullanılacak düzenli bir çalışma klasörü oluşturalım.

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

Ardından port, kimlik doğrulama ve veri yollarını belirlemek için bir Docker Compose dosyası hazırlayalı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

Parola satırındaki değeri kendi oluşturacağınız güçlü bir şifreyle değiştirmeniz zorunludur; bu, kurulumun güvenliği için kritik bir adımdır.

Yapılandırmayı tamamladıktan sonra n8n servisini Docker üzerinden başlatabilirsiniz. Bu işlem sırasında tüm gerekli bileşenler otomatik olarak indirilecek ve servis arka planda çalışmaya başlayacaktır.

docker-compose up -d

Kurulum tamamlandığında tarayıcı adres çubuğuna aşağıdaki adresi yazarak n8n’e erişebilirsiniz.

http://sunucu-ip-adresi:5678

Eğer temel kimlik doğrulaması aktifse giriş ekranı kullanıcı adı ve şifre girmenizi isteyerek açılır.

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ı Neden Olur ve Nasıl Düzeltilir?

Yorum yapın