A. Pendahuluan.

n8n (dibaca: "n-eight-n") adalah workflow automation tool yang bersifat open-source dan mendukung integrasi lebih dari 200 layanan. n8n memungkinkan pengguna untuk mengotomatiskan berbagai proses bisnis tanpa harus menulis kode dari nol. Dengan menggunakan Docker, kita dapat menginstal n8n secara cepat, ringan, dan terisolasi dari sistem utama.

Pada artikel ini akan membahas cara penginstallan n8n dengan menggunakan Docker di Linux OS.

B. Persiapan.

Sebelum melanjutkan instalasi n8n, pada artikel kali ini memerlukan persiapan service yang dibutuhkan seperti:

1. Sistem Operasi: Pada artikel kali ini menggunakan Ubuntu 22.04.
2. Docker: Seperti pada informasi sebelumnya, untuk instalasi n8n yaitu menggunakan docker. Pastikan telah menginstall Docker diserver, jika belum dapat melakukan install terlebih dahulu dengan mengikuti panduan pada artikel ini atau dengan mengikuti panduan dibawah:
   - Docker: Penjelasan, Fungsi dan Cara Install.
3. Koneksi Internet Stabil : Karena proses akan mengunduh image Docker dan dependensi lainnya.

Setelah menyiapkan service yang diperlukan, maka dapat melanjutkan ke tahap selanjutnya.

C. Instalasi
1. Update Sistem dan Instal Docker.

Silakan jalankan command berikut :

sudo apt update && sudo apt upgrade -y
sudo apt install -y docker.io docker-compose

2. Aktifkan Docker.

Setelah berhasil install Docker, maka dapat mengaktifkan Docker dengan menjalankan command berikut :

sudo systemctl enable docker
sudo systemctl start docker

3. Buat Direktori untuk n8n.

Pastikan membuat direktori untuk n8n dan masuk ke direktori yang baru dibuat tersebut dengan menjalankan command berikut :

mkdir -p ~/n8n-docker
cd ~/n8n-docker

D. Konfigurasi.

Selanjutnya silakan melakukan konfigurasi dengan urutan berikut :

1. Buat File .env.

Silakan membuat file .env dengan text editor yang biasa Anda gunakan, pada artikel ini menggunakan nano, berikut commandnya :

nano .env

Kemudian silakan isi dengan konfigurasi berikut :

# Waktu lokal
GENERIC_TIMEZONE=Asia/Jakarta

# URL Webhook default
WEBHOOK_TUNNEL_URL=http://localhost:5678

# Login dasar
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=passwordku123

# Penyimpanan data
N8N_DATA_FOLDER=/home/ubuntu/n8n-docker/data

Ubah password dan direktori sesuai kebutuhan Anda.

2. Buat File docker-compose.yml.

Selanjutnya silakan buat file docker-compose.yml dengan command berikut :

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_TUNNEL_URL=${WEBHOOK_TUNNEL_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}
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

3. Buat Direktori untuk Penyimpanan Data.

Selanjutnya silakan ketikan perintah berikut untuk membuat direktori penyimpanan Data nantinya :

mkdir -p ~/n8n-docker/data

Silakan sesuaikan dengan path direktori Anda.

4. Jalankan n8n.

Setelah langkah-langkah yang dibutuhkan telah selesai, maka dapat jalankan n8n dengan command berikut :

docker-compose up -d

Saat Command dijalankan maka akan (pull) image n8n dari Docker Hub (jika belum ada di di lokal) dan akan membuat container n8n dari image tersebut .

5. Cek Status Container.

Setelah n8n selesai dijalankan, silakan cek status container dengan command berikut untuk memastikan container n8n aktif dan berjalan di port 5678 :

docker ps

Setelah tampil seperti pada gambar diatas, maka artinya n8n sudah dapat diakses dari browser. Buka browser dan akses http://<IP-server>:5678

Apabila saat akses tampil pesan error seperti gambar diatas, maka error tersebut dikarenakan n8n secara default mengaktifkan fitur secure cookie, yaitu cookie hanya dikirim lewat HTTPS (TLS) untuk alasan keamanan. Tapi Anda saat ini mengaksesnya lewat HTTP biasa (tidak aman) atau menggunakan Safari. 

Silakan gunakan domain yang telah terinstall SSL dan arahkan ke IP server Anda. Opsinya dapat menonaktifkan Secure Cookie pada file .env (kalau hanya ingin testing dan tidak untuk publik), pada file .env dan file docker-compose.yml dapat ditambahkan baris berikut :

N8N_SECURE_COOKIE=false

Jika pada file .env dan file docker-compose.yml sudah ditambahkan, maka silakan restart n8n dengan command berikut : 

docker-compose down
docker-compose up -d

Selanjutnya silakan coba akses kembali dari browser, apabila sudah berhasil maka akan tampil halaman seperti pada gambar berikut.

E. Penutup.

Jika semua langkah dilakukan dengan benar, n8n akan berjalan di http://<ip-server/domain>:5678. Anda dapat login dengan username dan password yang telah diatur di file .env.

Semoga artikel ini dapat membantu Anda. Temukan bantuan lainnya melalui Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala silahkan hubungi support@biznetgio.com