Cara Install n8n: Panduan Lengkap untuk Pemula

Otomatisasi proses bisnis menjadi salah satu kebutuhan penting bagi perusahaan modern. Dengan semakin banyaknya aplikasi yang digunakan dalam operasional sehari-hari, integrasi antar sistem menjadi tantangan tersendiri. Salah satu solusi yang semakin populer adalah n8n, platform workflow automation open-source yang memungkinkan pengguna menghubungkan berbagai aplikasi dan layanan tanpa harus menulis banyak kode.

Dalam artikel ini, kita akan membahas cara install n8n menggunakan berbagai metode, mulai dari Docker hingga instalasi langsung di server Linux.

Apa Itu n8n?

n8n (dibaca "n-eight-n") adalah platform automation yang memungkinkan Anda membuat workflow untuk menghubungkan berbagai aplikasi seperti:

• Gmail

• Slack

• WhatsApp

• Google Sheets

• PostgreSQL

• MySQL

• HubSpot

• Notion

• OpenAI

• Dan ratusan layanan lainnya

Beberapa keunggulan n8n:

• Open-source

• Self-hosted

• Mendukung custom code

• Integrasi lebih dari 400 aplikasi

• Workflow visual yang mudah digunakan

• Biaya lebih rendah dibanding platform automation berbayar

Karena dapat di-host sendiri, n8n menjadi pilihan menarik bagi perusahaan yang membutuhkan kontrol penuh terhadap data dan infrastruktur.

Persyaratan Sistem

Sebelum melakukan instalasi, pastikan server memenuhi spesifikasi minimum berikut:

Minimum

• CPU: 1 Core

• RAM: 1 GB

• Storage: 10 GB

• Sistem Operasi:

  • Ubuntu 20.04+

  • Debian 11+

  • CentOS/RHEL

  • Docker Host

Rekomendasi Produksi

• CPU: 2 Core atau lebih

• RAM: 4 GB+

• SSD Storage

• Reverse Proxy (Nginx)

• SSL Certificate

Metode 1: Install n8n Menggunakan Docker (Direkomendasikan)

Docker merupakan metode instalasi yang paling mudah dan direkomendasikan untuk lingkungan produksi.

Install Docker

Ubuntu:

sudo apt update
sudo apt install docker.io -y
sudo systemctl enable docker
sudo systemctl start docker

Verifikasi:

docker --version

Menjalankan n8n dengan Docker

Buat volume untuk menyimpan data:

docker volume create n8n_data

Jalankan container:

docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8n

Jika berhasil, akses:

http://localhost:5678

Atau:

http://IP-SERVER:5678

Menjalankan n8n Secara Background

Gunakan mode daemon:

docker run -d \
--name n8n \
-p 5678:5678 \
-v n8n_data:/home/node/.n8n \
--restart unless-stopped \
docker.n8n.io/n8nio/n8n

Cek status:

docker ps

Metode 2: Install n8n Menggunakan Docker Compose

Untuk deployment yang lebih terstruktur, gunakan Docker Compose.

Buat file:

version: '3.8'

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n

    ports:
      - "5678:5678"

    volumes:
      - n8n_data:/home/node/.n8n

    restart: unless-stopped

volumes:
  n8n_data:

Simpan sebagai:

docker-compose.yml

Jalankan:

docker compose up -d

Verifikasi:

docker compose ps

Metode 3: Install n8n Menggunakan Node.js

Metode ini cocok untuk pengembangan atau testing.

Install Node.js

Ubuntu:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install nodejs -y

Verifikasi:

node -v
npm -v

Install n8n

Install global:

npm install n8n -g

Verifikasi:

n8n --version

Menjalankan n8n

n8n start

Akses melalui browser:

http://localhost:5678

Menggunakan PostgreSQL Sebagai Database

Secara default, n8n menggunakan SQLite. Namun untuk produksi disarankan menggunakan PostgreSQL.

Contoh konfigurasi:

export DB_TYPE=postgresdb

export DB_POSTGRESDB_HOST=localhost

export DB_POSTGRESDB_PORT=5432

export DB_POSTGRESDB_DATABASE=n8n

export DB_POSTGRESDB_USER=n8nuser

export DB_POSTGRESDB_PASSWORD=passwordku

Kemudian jalankan:

n8n start

Keuntungan PostgreSQL:

• Performa lebih baik

• Skalabilitas tinggi

• Mendukung multi-user

• Lebih stabil untuk workflow besar

Mengaktifkan Basic Authentication

Untuk keamanan tambahan, aktifkan login pada n8n.

export N8N_BASIC_AUTH_ACTIVE=true

export N8N_BASIC_AUTH_USER=admin

export N8N_BASIC_AUTH_PASSWORD=passwordkuat

Kemudian restart n8n.

Saat membuka dashboard, pengguna wajib login terlebih dahulu.

Konfigurasi Domain dan SSL

Untuk produksi, jangan menggunakan akses langsung melalui IP dan port.

Contoh:

https://automation.domainanda.com

Gunakan:

• Nginx Reverse Proxy

• SSL Let's Encrypt

• Firewall

Contoh konfigurasi:

sudo apt install nginx -y

Reverse proxy:

server {
    server_name automation.domainanda.com;

    location / {
        proxy_pass http://localhost:5678;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Aktifkan SSL:

sudo certbot --nginx

Menjalankan n8n Sebagai Service Linux

Jika menggunakan instalasi Node.js, buat service systemd.

Buat file:

sudo nano /etc/systemd/system/n8n.service

Isi:

[Unit]
Description=n8n Automation

[Service]
Type=simple
User=ubuntu
ExecStart=/usr/bin/n8n start
Restart=always

[Install]
WantedBy=multi-user.target

Aktifkan:

sudo systemctl daemon-reload

sudo systemctl enable n8n

sudo systemctl start n8n

Cek status:

sudo systemctl status n8n

Cara Update n8n

Jika menggunakan Docker:

docker pull docker.n8n.io/n8nio/n8n

Restart container:

docker stop n8n

docker rm n8n

Kemudian jalankan kembali container dengan image terbaru.

Jika menggunakan npm:

npm update -g n8n

Troubleshooting Umum

Port 5678 Sudah Digunakan

Cek proses:

sudo lsof -i :5678

Hentikan proses atau gunakan port lain:

-p 8080:5678

Tidak Bisa Mengakses Dashboard

Pastikan:

• Container berjalan

• Firewall mengizinkan port

• Reverse proxy aktif

• DNS mengarah ke server

Workflow Tidak Berjalan

Periksa log:

Docker:

docker logs n8n

Node.js:

journalctl -u n8n -f

Best Practice Deploy n8n di Produksi

Berikut beberapa rekomendasi untuk lingkungan produksi:

✅ Gunakan Docker atau Docker Compose

✅ Gunakan PostgreSQL sebagai database

✅ Aktifkan SSL/TLS

✅ Gunakan domain khusus

✅ Aktifkan autentikasi

✅ Backup workflow secara berkala

✅ Gunakan reverse proxy Nginx

✅ Update n8n secara rutin

✅ Simpan credential menggunakan encryption key

✅ Monitoring resource server

Kesimpulan

n8n adalah platform workflow automation yang powerful, fleksibel, dan hemat biaya untuk menghubungkan berbagai aplikasi dan layanan. Instalasi n8n dapat dilakukan dengan mudah menggunakan Docker, Docker Compose, maupun Node.js, tergantung kebutuhan dan lingkungan yang digunakan.

Untuk penggunaan produksi, kombinasi Docker, PostgreSQL, Nginx, dan SSL merupakan pilihan yang paling direkomendasikan karena memberikan keamanan, skalabilitas, dan kemudahan pengelolaan yang lebih baik. Dengan konfigurasi yang tepat, n8n dapat menjadi pusat otomatisasi yang membantu meningkatkan efisiensi operasional dan produktivitas bisnis secara signifikan.