Ubuntu 24.04 Sunucusunda n8n Kurulumu

yazar

n8n, kod yazmanıza gerek kalmadan otomasyon akışları tasarlayabileceğiniz açık kaynak bir platformdur. Birçok servisi kolayca entegre edebilmeniz, kendi altyapınızda çalıştırabilmeniz ve sınırsız iş akışı oluşturabilmeniz gibi güçlü özelliklere sahiptir.

Google Sheets, Slack, Discord, GitHub ve Notion gibi araçları birbirine bağlayarak günlük işlerinizi hızlandırabilir ve süreçlerinizi daha düzenli bir yapıya oturtabilirsiniz.

Ubuntu 24.04 Üzerine n8n Nasıl Kurulur?

İlk adım olarak sisteminizdeki paketleri güncelleyerek kuruluma hazırlık yapalım.

sudo apt update && sudo apt upgrade -y

Ardından Docker ortamını kurmamız gerekiyor. n8n farklı şekillerde kullanılabilir, ancak en güvenilir kullanım Docker ile sağlanır.

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

n8n’e özel dosyaların saklanacağı bir çalışma klasörü oluşturalım.

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

Port ve yapılandırma ayarlarını belirlemek için bir Docker Compose dosyası oluşturarak devam edelim.

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üvenliği sağlamak adına parola satırındaki değeri mutlaka kendi oluşturduğunuz güçlü bir şifreyle değiştirin.

Konfigürasyon hazır olduğunda n8n’i Docker ile başlatabilirsiniz. Bu işlem sırasında tüm gerekli dosyalar otomatik indirilecek ve servis arka planda devreye alınacaktır.

docker-compose up -d

Kurulum bittiğinde tarayıcıdan n8n arayüzüne ulaşabilirsiniz.

http://sunucu-ip-adresi:5678

Eğer kimlik doğrulama açıksa, sisteme giriş yapmanız için kullanıcı adı ve şifre ekranı karşınıza çıkar.anı kullanıcı adı ve şifre istemiyle açılacaktı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<br>sudo ufw allow 443<br>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<br>sudo docker compose pull
sudo docker compose down<br>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 Ağ Geçidi Zaman Aşımı Hatası Nasıl Düzelir?

Yorum yapın