A. Pendahuluan

n8n (dibaca: n-eight-n) adalah sebuah workflow automation tool berbasis open-source yang mendukung integrasi dengan lebih dari 200 layanan. n8n memungkinkan pengguna untuk mengotomatiskan berbagai proses bisnis secara visual tanpa harus menulis kode dari nol.

Dengan memanfaatkan Docker, instalasi n8n dapat dilakukan dengan cepat, ringan, serta terisolasi dari sistem utama, sehingga lebih mudah dalam pengelolaan dan pemeliharaan.

Pada artikel ini akan dibahas langkah-langkah instalasi n8n menggunakan Docker pada sistem operasi Linux (Ubuntu).

B. Persiapan

Sebelum melanjutkan proses instalasi n8n, pastikan beberapa kebutuhan berikut telah dipenuhi:

• Sistem Operasi: Ubuntu 22.04
• Docker: n8n akan dijalankan menggunakan Docker. Pastikan Docker telah terpasang di server.
  Jika belum, silakan lakukan instalasi Docker terlebih dahulu dengan mengikuti panduan berikut:
  Docker: Penjelasan, Fungsi, dan Cara Install
• Koneksi Internet Stabil: Dibutuhkan untuk mengunduh image Docker dan dependensi lainnya.

Setelah semua persiapan di atas terpenuhi, silakan lanjutkan ke tahap instalasi.

C. Instalasi

1. Update Sistem dan Install Docker

Jalankan perintah berikut untuk memperbarui sistem dan menginstal Docker beserta Docker Compose:

# sudo apt update && sudo apt upgrade -y

# sudo apt install -y docker.io docker-compose

2. Mengaktifkan Docker

Setelah Docker berhasil diinstal, aktifkan dan jalankan layanan Docker dengan perintah berikut:

# sudo systemctl enable docker

# sudo systemctl start docker

3. Membuat Direktori Kerja n8n

Buat direktori khusus untuk konfigurasi n8n, lalu masuk ke direktori tersebut:

# mkdir -p ~/n8n-docker

# cd ~/n8n-docker

D. Konfigurasi

1. Membuat File .env

Buat file .env menggunakan text editor (pada artikel ini menggunakan nano):

# nano .env

Isi file .env dengan konfigurasi berikut:

# Zona waktu
GENERIC_TIMEZONE=Asia/Jakarta

# URL webhook
WEBHOOK_URL=http://localhost:5678

# Basic Authentication
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=passwordku123
N8N_SECURE_COOKIE=false

# Lokasi penyimpanan data
N8N_DATA_FOLDER=/home/ubuntu/n8n-docker/data

Catatan:
Silakan ubah username, password, dan direktori penyimpanan sesuai dengan kebutuhan Anda.

2. Membuat File docker-compose.yml

Selanjutnya, buat file docker-compose.yml:

# nano docker-compose.yml

Isi dengan konfigurasi berikut:

version: "3.7"

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - WEBHOOK_URL=${WEBHOOK_URL}
      - N8N_BASIC_AUTH_ACTIVE=${N8N_BASIC_AUTH_ACTIVE}
      - N8N_BASIC_AUTH_USER=${N8N_BASIC_AUTH_USER}
      - N8N_BASIC_AUTH_PASSWORD=${N8N_BASIC_AUTH_PASSWORD}
      - N8N_SECURE_COOKIE=${N8N_SECURE_COOKIE}
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

3. Membuat Direktori Penyimpanan Data

Buat direktori untuk penyimpanan data n8n:

# mkdir -p ~/n8n-docker/data

Sesuaikan path direktori jika diperlukan.

4. Menjalankan n8n

Setelah semua konfigurasi selesai, jalankan n8n dengan perintah berikut:

# docker-compose up -d

Pada tahap ini, Docker akan mengunduh (pull) image n8n dari Docker Hub (jika belum tersedia di lokal) dan membuat container n8n.

5. Mengecek Status Container

Pastikan container n8n berjalan dengan baik menggunakan perintah berikut:

# docker ps

Jika container aktif dan berjalan di port 5678, maka n8n sudah siap digunakan.

Akses melalui browser:

http://<IP-server>:5678

6. Penanganan Error Secure Cookie

Apabila saat mengakses n8n muncul error terkait Secure Cookie, hal ini terjadi karena secara default n8n hanya mengizinkan cookie dikirim melalui HTTPS demi keamanan.

Solusi yang dapat dilakukan:

• Gunakan domain yang telah terpasang SSL (HTTPS) dan arahkan ke IP server
• Atau (untuk testing saja) nonaktifkan secure cookie

Tambahkan baris berikut pada file .env:

N8N_SECURE_COOKIE=false

Dan pada docker-compose.yml di bagian environment:

- N8N_SECURE_COOKIE=${N8N_SECURE_COOKIE}

Setelah itu, restart container:

# docker-compose down

# docker-compose up -d

Kemudian akses kembali melalui browser.

E. Penutup

Jika seluruh langkah di atas dilakukan dengan benar, maka n8n akan berjalan dan dapat diakses melalui:

http://<IP-server atau domain>:5678

Silakan login menggunakan username dan password yang telah dikonfigurasi pada file .env.
Dengan n8n, Anda dapat mulai membangun workflow automation sesuai kebutuhan bisnis Anda.

Semoga artikel ini dapat membantu Anda. Temukan bantuan lainnya melalui Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala silakan hubungi Support Biznet GIO melalui email support@biznetgio.com atau live chat maupun WA ke website www.biznetgio.com dan bisa juga melalui telepon ke nomor (021) 5714567.