3 Cara Install n8n via Docker, Docker Compose dan npm (Lengkap)

Kenapa Install n8n?

n8n jadi pilihan karena platform ini open-source dan bisa self-host, sehingga kamu punya kontrol penuh atas data dan workflow. 

Dibanding Zapier yang sifatnya SaaS dan terbatas pada paket berbayar, n8n lebih fleksibel, privat, dan bisa diskalakan sesuai kebutuhan.

Install n8n di Cloud dan Self-Host, Mana yang Lebih Baik?

Kalau bicara soal cara install, ada beberapa opsi yang bisa kamu pilih, baik install di cloud atau self-host via docker. Berikut perbandingan cara instalasi n8n:

1. Cloud

Tidak perlu setup, infrastruktur dikelola pihak n8n, dan otomatis scaling. Hanya saja biayanya tinggi dan kontrol backend terbatas.

Lebih cocok untuk pengguna non-teknis yang ingin cepat memulai tanpa repot setup.

2. Self-host via Docker

Ini lebih cocok bagi yang butuh kontrol penuh. Biayanya lebih rendah dan mudah backup data. 

Namun perlu setup awal dan pemeliharaan server. Kurang cocok untuk tidak familier dengan teknis.

3. npm (Node.js)

npm membutuhkan konfigurasi manual, sehingga lebih cocok untuk pengguna tingkat lanjut atau kasus penggunaan khusus. Kelebihannya fleksibilitas maksimal dan bisa dikustomisasi sepenuhnya. 

Syarat Install n8n

n8n membutuhkan beberapa syarat agar instalasinya lancar dan bisa langsung kamu gunakan. Adapun syaratnya yaitu:

1. Server Ubuntu

n8n membutuhkan server dengan sistem operasi Ubuntu 22.04 atau yang lebih baru agar stabil selama instalasi.

2. Domain yang Terdaftar

Sobat juga membutuhkan nama domain yang sudah terhubung ke server. Nantinya berfungsi untuk konfigurasi SSL dan akses melalui HTTPS.

3. Akses Root atau Sudo

Pastikan kamu punya akses root atau hak istimewa sudo agar bisa menjalankan perintah instalasi.

4. Docker dan Docker Compose

n8n dijalankan lewat Docker, jadi kamu harus menginstal Docker dan Docker Compose terlebih dahulu. Bagi yang belum memilikinya, bisa instal dengan perintah berikut:

• sudo apt update  
• sudo apt install docker.io docker-compose -y

5. Akun Email (Opsional)

Kalau ingin menggunakan SSL gratis dari Let’s Encrypt, Sobat disarankan punya akun email aktif untuk proses verifikasi nantinya.

Cara Install n8n di Docker

Jika syarat sudah terpenuhi, selanjutnya kamu bisa mulai install n8n Docker. Kenapa pakai Docker? Tujuannya agar instalasi n8n lebih cepat, hanya 5 menit. 

Tinggal jalankan beberapa perintah di terminal, instalasi akan berjalan otomatis. Berikut caranya:

1. Buat Volume 

Buat volume untuk menyimpan semua data n8n agar tetap aman meski container di-restart.

docker volume create n8n_data

Buat Volume Data | Dok: n8n

2. Jalankan Container n8n

Isi Data ke Kontainer | Sumber: n8n

Jalankan kontainer n8n dan isi kolom-kolom yang kosong dengan data-data berikut, jangan lupa ubah <YOUR_TIMEZONE> dengan zona waktu kamu:

docker run -it --rm \

 --name n8n \

 -p 5678:5678 \

 -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \

 -e TZ="<YOUR_TIMEZONE>" \

 -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \

 -e N8N_RUNNERS_ENABLED=true \

 -v n8n_data:/home/node/.n8n \

 docker.n8n.io/n8nio/n8n

Jika sudah, tekan tombol Run untuk menjalankan instalasi. Tunggu sampai prosesnya selesai.

Hasil Pengisian Kontainer | Dok: n8n

3. Akses n8n

Untuk memastikan instalasi lancar, buka browser dan akses http://localhost:5678, hasilnya n8n sudah siap dipakai untuk otomatisasi pekerjaanmu. 

Masuk dengan email dan password yang terdapat di file .env.

Cara Install n8n di npm

npm (Node Package Manager) adalah alat untuk mengelola paket atau library JavaScript. Saat pakai npm, kamu bisa mengunduh dan menginstal n8n.

Namun, npm membutuhkan Node.js terinstall di komputer. Untuk n8n, versi Node.js yang support adalah 20.19 sampai 24.x.

1. Install n8n

Untuk penggunaan permanen, ikuti perintah npm install n8n berikut:

npm install -g n8n

Jika ingin install versi tertentu, gunakan:

npm install -g [email protected]

Kalau ingin versi terbaru beta, berikut perintahnya:

npm install -g n8n@next

Setelah terpasang, jalankan n8n:

n8n start

2. Update n8n

Selanjutnya, update n8n ke versi terbaru dengan:

npm update -g n8n

Jika ingin update ke versi beta, gunakan:

npm install -g n8n@next

Cara Install n8n di Server Pribadi (Docker Compose)

Docker Compose membuat instalasi n8n lebih mudah dan rapi, karena semua dependensi sudah terkemas dalam kontainer dan pengelolaan mudah.

1. Buat Direktori Proyek

Buat folder khusus untuk menyimpan semua file konfigurasi:

mkdir n8n-installation

cd n8n-installation

2. Buat File Docker Compose

Buat file ini yang berisi pengaturan kontainer n8n, termasuk port, volume, dan variabel lingkungan.

nano docker-compose.yml

Salin dan tempel kode berikut:

services:

  n8n:

    image: docker.n8n.io/n8nio/n8n

    restart: unless-stopped

    ports:

      - "5678:5678"

    volumes:

      - ~/.n8n:/home/node/.n8n

    environment:

      - N8N_HOST=localhost

      - N8N_PORT=5678

      - N8N_PROTOCOL=http

3. Jalankan n8n

Perintah ini akan menjalankan kontainer di latar belakang secara otomatis:

docker compose up -d

4. Akses n8n

Setelah kontainer berjalan, akses di browser melalui http://localhost:5678. Jika menggunakan VPS/Server remote, gunakan http://[alamat_IP_server_kamu]:5678.

Selanjutnya, antarmuka n8n sudah bisa kamu akses untuk mulai membuat workflow.

Masalah Umum saat Instalasi

Pahami beberapa masalah umum yang bisa muncul saat instalasi, terutama bagi yang memakai Docker Compose atau Node.js:

1. Error: Missing Packages

n8n membutuhkan paket-paket tertentu tersedia saat startup. Jika paket tidak tersedia, akan muncul eror missing packages. Paket-paket bisa hilang saat mencoba recreate kontainer atau saat upgrade n8n.

Solusi:

Simpan konten direktori direktori ~/.n8n/nodes agar paket tetap ada saat kontainer di-restart.

2. n8n Crash

Jika instance n8n Cloud crash, Sobat cukup menonaktifkan semua community nodes agar instance bisa booting.

Solusi:

Buka Cloud Admin Panel > Manage. Lalu aktifkan toggle Disable all community nodes.

FAQ

Bagaimana cara install n8n?

Ada banyak cara untuk menginstal alat ini, yaitu melalui Docker, npm (Node.js) dan cloud. Masing-masing memiliki kelebihan dan kekurangannya.

n8n apakah gratis?

Ya, n8n menawarkan versi open-source yang gratis untuk penggunaan self-hosting. Jika memilih versi cloud, maka kamu perlu mengeluarkan biaya tambahan.

Bagaimana cara mengakses n8n lokal?

Kamu bisa mengaksesnya melalui browser melalui http://localhost:5678. Jika ingin menggunakan webhook, n8n menyediakan opsi tunnel agar instance lokal kamu dapat mengaksesnya dari internet (hanya untuk testing, bukan untuk produksi).

Tidak Mau Repot Install n8n? Pakai n8n Hosting Pre-Installed dari Jagoan Hosting

Daripada repot install n8n manual, apalagi bagi yang belum familier dengan teknis, lebih baik pilih n8n hosting terbaik dari Jagoan Hosting. 

Semua sudah pre-installed dan terintegrasi dengan 200+ aplikasi, jadi kamu bisa langsung mulai membuat workflow tanpa ribet.

Dengan memilih layanan kami, kamu akan mendapatkan customer support via WhatsApp selama 24/7 untuk semua kendala dan pertanyaan selama menggunakan n8n hosting.

Tertarik coba? Konsultasi gratis sekarang agar bisa menemukan hosting yang sesuai demi kelancaran workflow kamu!