Cara Install n8n: Docker, Docker Compose, VPS, dan Hostinger
Panduan cara install n8n: lokal lewat npx, Docker, Docker Compose di VPS dengan HTTPS, sampai template Hostinger. Plus backup, update, dan troubleshooting.
Cara install n8n paling cepat adalah memakai n8n Cloud trial atau perintah "npx n8n" di laptop. Untuk dipakai bisnis 24 jam, jalankan n8n lewat Docker Compose di VPS dengan domain dan HTTPS. Panduan ini membahas semua jalurnya, dari coba-coba di laptop sampai instalasi produksi yang aman, termasuk cara pakai template n8n di VPS Hostinger.
Kalau kamu belum tahu n8n itu apa, baca dulu n8n Adalah: Pengertian dan Cara Kerjanya. Kalau sudah, ayo mulai.
Pilih Jalur Install n8n yang Cocok
Tidak ada satu cara install yang paling benar. Yang ada adalah cara yang paling cocok dengan tujuanmu:
- n8n Cloud trial. Daftar di situs resmi n8n dan langsung dapat editor di browser. Paling cepat untuk belajar, tanpa urusan server. Setelah trial, berbayar.
- Lokal tanpa Docker (Node.js). Jalankan "npx n8n" atau "npm install -g n8n" di laptop. Gratis, cocok untuk belajar, tapi mati saat laptop dimatikan.
- Docker di laptop. Lebih rapi dari jalur Node.js karena data tersimpan di volume, dan sama persis dengan cara n8n dijalankan di server.
- Docker Compose di VPS (self-hosted). Jalur produksi: n8n hidup 24 jam, punya domain sendiri, dan memakai HTTPS. Ini yang dibutuhkan kalau webhook dan workflow bisnis harus selalu jalan.
- Template n8n di VPS Hostinger. Jalan pintas kalau kamu memakai VPS Hostinger: n8n dipasang lewat template OS dari panel, tanpa menyusun Docker sendiri.
Saran kami untuk pemula: belajar dulu di Cloud trial atau lokal, baru pindah ke VPS setelah kamu paham alurnya. Jangan habiskan berhari-hari menyiapkan server sebelum membuat satu workflow pun.
Spesifikasi VPS untuk n8n
Angka di bawah ini perkiraan awal, bukan jaminan kapasitas. Ukur sendiri pemakaian memori dan durasi eksekusi dengan workflow yang benar-benar kamu jalankan.
- Coba-coba atau personal: 1 sampai 2 vCPU, RAM 2 GB, SSD 20 GB.
- Bisnis kecil: 2 vCPU, RAM 2 sampai 4 GB, SSD 40 GB.
- Produksi atau AI agent: 4 vCPU, RAM 4 sampai 8 GB, SSD 60 sampai 100 GB, plus rencana database terpisah.
Tutorial resmi Hostinger menyebut minimal 1 GB RAM dan 1 core CPU, dengan rekomendasi 2 GB RAM dan 2 core. Pilih region server (misalnya Jakarta atau Singapura) berdasarkan latensi nyata dan kebutuhan penanganan data. Selain biaya VPS, anggarkan juga backup, storage, monitoring, dan biaya API layanan yang kamu sambungkan.
Cara Install n8n di Laptop Tanpa Docker
Jalur paling ringan untuk belajar, cukup Node.js:
- 01Pasang Node.js versi LTS dari situs resminya.
- 02Buka terminal (PowerShell di Windows, Terminal di Mac atau Linux).
- 03Jalankan "npx n8n" untuk langsung mencoba, atau "npm install -g n8n" lalu ketik "n8n" kalau ingin memasangnya permanen.
- 04Buka http://localhost:5678 di browser dan buat akun owner pertama.
Kekurangannya: n8n berhenti setiap kali terminal ditutup. Cukup untuk belajar, tidak untuk workflow yang harus jalan terus.
Cara Install n8n dengan Docker
Docker membuat instalasi n8n rapi dan mudah diulang. Kamu butuh Docker Desktop (Mac, Windows, Linux) atau Docker Engine di server Linux. Perintah berikut mengikuti dokumentasi resmi n8n:
- 01Buat volume penyimpanan data: "docker volume create n8n_data".
- 02Jalankan n8n: "docker run -it --rm --name n8n -p 5678:5678 -e GENERIC_TIMEZONE=Asia/Jakarta -e TZ=Asia/Jakarta -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true -v n8n_data:/home/node/.n8n n8nio/n8n".
- 03Buka http://localhost:5678 dan selesaikan setup akun.
Arti tiap bagiannya:
- -p 5678:5678 membuka port editor n8n di komputermu.
- GENERIC_TIMEZONE mengatur zona waktu untuk node terjadwal seperti Schedule Trigger. TZ mengatur zona waktu sistem.
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true memaksa izin file konfigurasi yang aman.
- -v n8n_data:/home/node/.n8n menyimpan workflow, credential, dan encryption key di luar container. Tanpa ini, semuanya hilang saat container dihapus.
Cara Install n8n di VPS dengan Docker Compose dan HTTPS
Ini jalur untuk instalasi sungguhan. Contoh di bawah memakai Ubuntu 22.04 atau 24.04, domain sendiri (misalnya n8n.domainkamu.com), dan Caddy sebagai reverse proxy yang mengurus sertifikat HTTPS otomatis.
Langkah 1: Siapkan Server dan Domain
- 01Masuk ke VPS lewat SSH, lalu update sistem: "apt update && apt upgrade -y".
- 02Pasang Docker Engine dan plugin Compose mengikuti petunjuk resmi Docker untuk Ubuntu. Cek dengan "docker --version" dan "docker compose version".
- 03Di panel DNS domainmu, buat record A untuk n8n.domainkamu.com yang mengarah ke IP publik VPS. Tunggu propagasi DNS.
- 04Buat folder proyek: "mkdir ~/n8n && cd ~/n8n".
Langkah 2: Tulis File docker-compose.yml
Buat file "docker-compose.yml" di folder tadi dengan dua service.
Service n8n berisi:
- Image n8n dengan tag versi yang dipin, misalnya "n8nio/n8n:2.46.6". Itu versi terbaru di halaman rilis GitHub n8n saat artikel ini ditulis (4 November 2026). Cek dulu versi stabil terbaru sebelum memakainya, jangan menyalin angka ini begitu saja.
- "restart: always" supaya n8n menyala lagi setelah VPS reboot.
- Environment "N8N_HOST=n8n.domainkamu.com" dan "N8N_PROTOCOL=https".
- Environment "N8N_WEBHOOK_URL=https://n8n.domainkamu.com/" supaya URL webhook yang ditampilkan n8n memakai domainmu. Nama lama "WEBHOOK_URL" sudah deprecated sejak n8n 2.35.0.
- Environment "N8N_PROXY_HOPS=1" karena ada satu reverse proxy (Caddy) di depan n8n.
- Environment "GENERIC_TIMEZONE=Asia/Jakarta" dan "TZ=Asia/Jakarta".
- Volume "n8n_data:/home/node/.n8n".
- Tanpa bagian ports. Port 5678 tidak perlu dibuka ke internet karena Caddy yang meneruskan trafik.
Service caddy berisi:
- Image Caddy resmi dengan tag versi yang dipin.
- "restart: always".
- Ports "80:80" dan "443:443".
- Volume "./Caddyfile:/etc/caddy/Caddyfile" dan volume "caddy_data:/data" untuk menyimpan sertifikat.
Di bagian bawah file, deklarasikan dua volume bernama: n8n_data dan caddy_data.
Langkah 3: Tulis Caddyfile
Buat file bernama "Caddyfile" di folder yang sama, isinya cukup satu blok: "n8n.domainkamu.com { reverse_proxy n8n:5678 }". Caddy akan mengambil sertifikat SSL dari Let's Encrypt secara otomatis.
Langkah 4: Jalankan dan Buat Akun Owner
- 01Sebelum menyalakan, batasi akses HTTPS hanya dari IP kamu lewat firewall penyedia VPS, supaya halaman pembuatan akun owner tidak bisa diakses orang lain. Pastikan Caddy tetap bisa memvalidasi sertifikat.
- 02Jalankan "docker compose up -d".
- 03Buka https://n8n.domainkamu.com dan buat akun owner pertama.
- 04Setelah akun owner jadi, atur akses sesuai kebutuhan.
Langkah 5: Atur Firewall
Contoh UFW untuk host: "ufw allow OpenSSH", "ufw allow 80", "ufw allow 443", lalu "ufw enable". Pastikan akses SSH tetap terbuka sebelum mengaktifkan UFW.
Satu jebakan penting: port yang dipublikasikan Docker bisa melewati aturan UFW. Jadi jangan hanya mengandalkan UFW. Pakai juga firewall dari panel penyedia VPS, dan jangan pernah mempublikasikan port 5678 kalau tidak perlu.
Terakhir, verifikasi HTTPS, login owner, dan satu webhook uji yang tidak menyentuh data bisnis. Editor yang bisa dibuka belum berarti siap produksi.
Tentang Panduan Docker Compose Resmi n8n
Contoh di atas sengaja minimal: n8n plus Caddy, dengan database SQLite bawaan. Panduan Docker Compose resmi n8n lebih lengkap. Panduan itu menyertakan service sandbox dan runner untuk n8n Assistant, mensyaratkan minimal RAM 4 GB dan 2 vCPU, memakai SQLite sebagai default, dan merekomendasikan Postgres untuk produksi. Data SQLite yang sudah ada tidak otomatis pindah ke Postgres, jadi putuskan database sejak awal kalau instance ini akan dipakai serius.
Cara Install n8n di VPS Hostinger dengan Template
Kalau VPS-mu dari Hostinger, ada jalan pintas resmi lewat template OS. Menurut tutorial resmi Hostinger:
- 01Di hPanel, buka menu VPS, pilih VPS-mu, lalu klik Manage.
- 02Buka dropdown OS & Panel, pilih Operating System.
- 03Di panel Change OS, cari "n8n", pilih template n8n, lalu klik Change OS.
- 04Akan muncul peringatan bahwa OS VPS ditimpa dan semua file dihapus. Centang konfirmasi, isi password root, lalu konfirmasi.
- 05Setelah instalasi selesai, buka halaman VPS Overview dan klik Manage App untuk masuk ke n8n.
Penting: ganti OS berarti server dihapus total. Pakai jalur ini hanya untuk VPS baru atau setelah semua data penting dibackup. Kemudahan template tidak menghapus tanggung jawabmu soal update, backup, dan keamanan.
Keamanan dan Backup n8n Self-Hosted
- Batasi akses. Pakai HTTPS, akun owner, dan akses jaringan seperlunya. Jangan buka port 5678 ke publik.
- Backup yang bisa dipulihkan. Untuk SQLite bawaan, hentikan n8n sebelum menyalin volume n8n_data, atau pakai snapshot yang konsisten. Untuk Postgres, backup database-nya juga, volume saja tidak cukup. Lihat dokumentasi backup dan restore n8n.
- Simpan encryption key. Credential di n8n dienkripsi dengan key yang ada di folder .n8n atau di variabel N8N_ENCRYPTION_KEY. Tanpa key ini, credential hasil restore tidak bisa dibuka. Simpan bersama backup dengan akses terbatas, dan jangan pernah masukkan ke Git.
- Latih restore. Backup yang belum pernah dicoba dipulihkan belum terbukti backup. Ekspor JSON workflow saja juga bukan backup instance yang lengkap.
Cara Update n8n dengan Aman
- 01Baca catatan rilis versi tujuan di halaman rilis GitHub n8n, dan cek security advisories n8n untuk tahu patch keamanan mana yang relevan.
- 02Ambil backup lengkap dan simpan encryption key.
- 03Uji versi baru di instance staging terpisah dulu, terutama kalau kamu melompati banyak versi atau pindah dari 1.x ke 2.x.
- 04Ubah tag image di docker-compose.yml ke versi yang sudah kamu uji, lalu jalankan "docker compose pull" diikuti "docker compose up -d".
- 05Cek versi yang berjalan dengan "docker compose exec n8n n8n --version", lalu periksa log dan beberapa workflow penting.
Hindari tag "latest" di produksi. Versi yang dipin membuat update jadi keputusan sadar, bukan kejutan.
Troubleshooting Install n8n
- Error "port 5678 is already in use". Ada aplikasi lain di port itu. Hentikan aplikasinya, atau jalankan n8n di port lain dengan variabel "N8N_PORT=5679".
- Permission denied saat memakai Docker di Linux. User-mu belum masuk grup Docker. Jalankan "sudo usermod -aG docker $USER", logout, lalu login lagi.
- localhost:5678 tidak bisa dibuka. Biasanya n8n belum selesai start. Tunggu beberapa detik lalu refresh. Kalau tetap gagal, cek log dengan "docker logs n8n" atau "docker compose logs n8n".
- Workflow dan credential hilang setelah restart. Container dijalankan tanpa volume. Selalu pasang "-v n8n_data:/home/node/.n8n" atau volume yang sama di Compose.
- Sertifikat HTTPS tidak terbit. Cek record A domain sudah mengarah ke IP VPS dan port 80 serta 443 terbuka di firewall penyedia.
Self-Hosted atau n8n Cloud?
- Self-hosted: kamu memilih server dan konfigurasi sendiri, tapi timmu yang bertanggung jawab atas update, backup, dan pemulihan. Biayanya infrastruktur plus waktu pengelolaan.
- n8n Cloud: platform diurus oleh n8n, kamu membayar langganan. Workflow tetap perlu kamu rawat sendiri.
Soal lisensi: n8n Community Edition bersifat fair-code dan source-available di bawah Sustainable Use License, bukan open source dalam arti sempit. Untuk belajar, dipakai sendiri, atau membangun workflow untuk klien, tidak ada biaya lisensi. Baca teks lisensinya kalau kamu berencana menjual ulang n8n sebagai layanan.
Self-host juga tidak otomatis menjamin privasi: data tetap dikirim ke layanan AI atau SaaS yang kamu sambungkan di workflow.
Setelah n8n Terpasang
Instalasi hanya langkah pertama. Lanjutkan dengan workflow pertamamu lewat Belajar n8n dari Nol. Mau titik awal yang sudah jadi? Ada puluhan template terbuka buatan Fahmi Fahreza di profil creator n8n yang bisa kamu impor dan bongkar. Tinjau node dan credential tiap template, lalu uji dulu sebelum disambungkan ke data asli.
Kalau kamu ingin belajar berurutan, kelas n8n Dari 0 Sampai Jago punya materi khusus self-host lewat Sumopod, lalu berlanjut ke trigger, API, webhook, sampai capstone project.
Kalau bisnismu ingin n8n dipasang dan dirawat oleh tim profesional, tim WithMi Automation menangani itu lewat jasa implementasi n8n.
FAQ
- Apa cara paling mudah install n8n untuk pemula?
- Paling mudah adalah n8n Cloud trial di situs resmi n8n, tanpa server. Kalau mau gratis di laptop, pasang Node.js lalu jalankan npx n8n dan buka http://localhost:5678.
- Apakah harus pakai Docker untuk install n8n?
- Tidak wajib. Kamu bisa memakai Node.js untuk belajar. Docker dan Docker Compose disarankan untuk server karena data tersimpan di volume, konfigurasinya bisa diulang, dan update lebih terkendali.
- Berapa spesifikasi VPS untuk n8n?
- Sebagai perkiraan awal, 2 vCPU dan RAM 2 GB cukup untuk instance kecil. Workflow AI, eksekusi paralel, dan file besar butuh lebih. Panduan Docker Compose resmi n8n yang menyertakan sandbox Assistant mensyaratkan minimal RAM 4 GB dan 2 vCPU.
- Apakah n8n self-hosted gratis?
- Community Edition tidak dikenai biaya lisensi untuk penggunaan yang diizinkan Sustainable Use License. Kamu tetap membayar server, backup, dan API layanan yang disambungkan.
- Bagaimana cara install n8n di Hostinger?
- Di hPanel buka VPS, klik Manage, pilih OS & Panel lalu Operating System, cari template n8n, dan klik Change OS. Langkah ini menghapus semua file di VPS, jadi backup dulu. Setelah selesai, buka n8n lewat Manage App di halaman VPS Overview.
- Bagaimana cara update n8n yang dijalankan dengan Docker Compose?
- Baca catatan rilis dan security advisories, backup data serta encryption key, uji di staging, ganti tag image ke versi yang sudah diuji, lalu jalankan docker compose pull dan docker compose up -d.
Siap berhenti membaca dan mulai membangun?
Ikuti panduan yang sama yang dipakai murid kami untuk pergi dari nol sampai sistem AI otomatis.