Panduan Lengkap Install n8n Menggunakan Docker

masukkan script iklan disini

n8n adalah platform otomasi alur kerja (workflow automation) open-source yang fleksibel, dapat diperluas, dan dapat di-hosting sendiri. Salah satu cara paling praktis untuk menjalankan n8n adalah menggunakan Docker. Dengan Docker, Anda bisa mengelola lingkungan eksekusi n8n dengan lebih konsisten dan mudah dipindahkan ke server manapun.

Persyaratan Sistem

Sebelum memulai, pastikan sistem Anda sudah memiliki:

• Docker (v20.10 atau lebih baru)

• Docker Compose (v2.0 atau lebih baru)

• Akses ke terminal / shell

• Internet stabil

Langkah-Langkah Instalasi

1. Buat Folder Proyek

Buka terminal, lalu buat direktori kerja baru untuk proyek n8n Anda:

mkdir n8n-docker
cd n8n-docker

2. Buat File .env

File ini menyimpan konfigurasi lingkungan. Buat file .env:

touch .env

Isi dengan:

# Umum
GENERIC_TIMEZONE=Asia/Jakarta
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=admin123

# Lokasi data
DATA_FOLDER=/home/user/n8n-data

Ubah username, password, dan path DATA_FOLDER sesuai kebutuhan Anda.

3. Buat File docker-compose.yml

Ini adalah file utama untuk menjalankan n8n via Docker Compose. Buat file docker-compose.yml:

version: "3.8"

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - 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_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
    volumes:
      - ${DATA_FOLDER}:/home/node/.n8n

Pastikan direktori DATA_FOLDER ada dan dapat ditulis oleh Docker.

4. Jalankan n8n

Jalankan perintah berikut di terminal:

docker compose up -d

Tunggu beberapa detik, lalu buka browser dan akses:

http://localhost:5678

Masukkan username dan password sesuai dengan yang Anda tetapkan di file .env.

5. (Opsional) Menjalankan di Background dengan Logging

Untuk melihat log:

docker compose logs -f

Untuk menghentikan layanan:

docker compose down

Tips Keamanan

• Ganti kredensial default Anda sebelum digunakan di produksi.

• Gunakan reverse proxy seperti Nginx atau Traefik + HTTPS (dengan Let's Encrypt).

• Simpan volume data Anda secara teratur (backup).

Penutup

Dengan mengikuti langkah-langkah di atas, Anda kini memiliki instance n8n yang berjalan secara lokal atau di server Anda menggunakan Docker. Anda bisa mulai membangun workflow otomatisasi dari UI n8n dengan antarmuka grafis yang intuitif.

Jika Anda ingin menjalankan n8n di lingkungan produksi (server VPS atau cloud), sangat disarankan untuk menambahkan SSL, subdomain, dan sistem logging yang terintegrasi seperti Grafana + Prometheus.