Ringkasan Singkat: Menjalankan n8n secara lokal memerlukan npm (Node.js 20.19-24.x) atau Docker. Metode tercepat menggunakan npx n8n untuk pengujian langsung tanpa instalasi, sementara Docker memberikan isolasi yang lebih baik dan kesiapan produksi. Kedua metode memberi Anda akses penuh ke kemampuan otomatisasi alur kerja n8n tanpa biaya cloud berulang.
Menyiapkan n8n di mesin lokal menghilangkan biaya langganan berulang sambil memberikan kontrol penuh atas otomatisasi alur kerja. Menurut dokumentasi resmi n8n, platform ini membutuhkan versi Node.js antara 20.19 dan 24.x untuk instalasi npm, atau Docker untuk penyebaran terkontainerisasi.
Keputusan antara hosting lokal dan layanan cloud memengaruhi anggaran dan fleksibilitas. Menurut diskusi komunitas, instalasi lokal menangani alur kerja tanpa batas, sementara paket cloud mencakup penetapan harga berdasarkan eksekusi (mulai dari $24/bulan untuk 2.500 eksekusi menurut beberapa laporan pengguna).
Prasyarat untuk Instalasi Lokal
Sebelum menginstal n8n secara lokal, sistem memerlukan perangkat lunak tertentu tergantung pada metode yang dipilih.
Versi Node.js yang diperlukan untuk instalasi npm sepenuhnya bergantung pada persyaratan spesifik versi n8n yang Anda sebarkan, karena npm sendiri kompatibel dengan semua versi LTS Node.js yang didukung saat ini. Dokumentasi resmi menentukan rentang versi yang tepat ini untuk kompatibilitas. Periksa versi saat ini dengan menjalankan node --version di terminal.
Instalasi Docker memerlukan Docker Engine atau Docker Desktop. Tim n8n merekomendasikan Docker untuk sebagian besar kebutuhan self-hosting karena memberikan isolasi yang bersih dan menghindari ketidakcocokan sistem operasi.
Persyaratan Sistem
Instans n8n lokal berjalan pada sistem Windows, macOS, dan Linux. Tidak ada spesifikasi RAM minimum yang muncul dalam dokumentasi resmi, tetapi kompleksitas alur kerja menentukan kebutuhan sumber daya aktual.
Instalasi mengonsumsi ruang disk minimal pada awalnya. Kebutuhan penyimpanan bertambah berdasarkan data alur kerja, riwayat eksekusi, dan paket node kustom.
Metode 1: Menjalankan n8n dengan npm
Instalasi npm menyediakan jalur tercepat untuk menjalankan n8n secara lokal. Metode ini bekerja langsung pada sistem host tanpa kontainerisasi.
Mulai Cepat dengan npx
Pendekatan paling sederhana menggunakan npx tanpa instalasi permanen. Buka terminal dan jalankan:
| npx n8n |
Perintah ini mengunduh semua yang diperlukan dan memulai n8n secara otomatis. Antarmuka dapat diakses di localhost:5678 dalam hitungan detik.
Metode npx bekerja sempurna untuk pengujian dan evaluasi. Ini tidak memerlukan paket npm global atau perubahan sistem permanen.
Instalasi npm Global
Untuk instalasi permanen, paket npm global menyediakan akses yang konsisten:
| npm install n8n -g |
Setelah instalasi selesai, mulai n8n kapan saja dengan menjalankan:
| n8n |
Versi stabil utama n8n saat ini adalah 2.x (misalnya, 2.10.4). Versi beta mungkin berisi fitur yang tidak stabil dan harus dihindari untuk alur kerja produksi.
Konfigurasi dan Penyimpanan Data
Instalasi npm menyimpan data alur kerja di direktori ~/.n8n secara default. Lokasi ini berisi kredensial, definisi alur kerja, dan riwayat eksekusi.
Variabel lingkungan mengontrol perilaku n8n. Atur variabel N8N_PORT untuk mengubah port default 5678. Variabel lain mengonfigurasi koneksi database, URL webhook, dan pengaturan otentikasi.
Metode 2: Menjalankan n8n dengan Docker
Instalasi Docker mewakili pendekatan yang direkomendasikan untuk hosting n8n lokal. Dokumentasi resmi menekankan Docker untuk kebutuhan self-hosting produksi.
Perintah Dasar Docker Run
Mulai n8n dengan satu perintah Docker:
| docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Perintah ini membuat kontainer bernama n8n, memetakan port 5678 ke host, dan mempertahankan data di direktori ~/.n8n.
Kontainer berjalan secara interaktif dengan flag -it. Hapus --rm untuk menyimpan kontainer setelah menghentikannya.
Docker Compose untuk Penyiapan Produksi
Konfigurasi Docker Compose memberikan kontrol yang lebih baik untuk lingkungan produksi. Repositori n8n-hosting di GitHub berisi file Docker Compose yang siap digunakan untuk berbagai arsitektur.
Konfigurasi docker-compose.yml dasar terlihat seperti ini:
| version: '3.8' services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=password volumes: - ~/.n8n:/home/node/.n8n |
Mulai tumpukan dengan:
| docker-compose up -d |
Flag -d menjalankan kontainer dalam mode terpisah, memungkinkan penggunaan terminal untuk tugas lain.
Konfigurasi Awal dan Akses
Setelah memulai n8n melalui salah satu metode, navigasikan ke localhost:5678 di browser web. Layar penyiapan awal meminta alamat email dan kata sandi untuk akun admin.
Pengguna pertama ini menjadi pemilik instans dengan hak administratif penuh. Pengguna tambahan dapat ditambahkan nanti melalui antarmuka manajemen pengguna.
Penyiapan Otentikasi
Untuk keamanan, aktifkan otentikasi bahkan pada instalasi lokal. Konfigurasi Docker Compose menerima variabel lingkungan otentikasi secara langsung:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=strongpassword |
Variabel ini mengaktifkan otentikasi dasar HTTP, yang memerlukan kredensial untuk semua upaya akses.
Menguji Node Kustom Secara Lokal
Dokumentasi resmi menjelaskan cara menguji node kustom selama pengembangan. Instal n8n secara global terlebih dahulu, lalu bangun dan tautkan paket node kustom.
Di direktori node kustom, jalankan:
| npm run build npm link |
Kemudian navigasikan ke direktori node n8n (biasanya ~/.n8n/custom/) dan tautkan paket:
| npm link <nama-paket-node> |
Node kustom muncul di antarmuka n8n setelah memulai ulang instans.
Sumber Daya Otomatisasi Bermanfaat untuk Digunakan Dengan n8n
Jika Anda sedang belajar cara menjalankan n8n secara lokal dan menguji alur kerja di mesin Anda, Anda mungkin juga mendapat manfaat dari alat bantu dan templat eksternal yang mempermudah otomatisasi tugas umum. Get AI Perks menawarkan perpustakaan templat alur kerja dan alat yang dibantu AI yang dapat Anda gunakan bersama n8n atau untuk membuat prototipe ide otomatisasi sebelum Anda membuatnya sendiri.
Dengan Get AI Perks, Anda dapat:
- Mulai dari templat alur kerja yang sudah dibuat sebelumnya
- Dapatkan bantuan AI untuk logika dan konten rutin
- Jelajahi pola otomatisasi umum sebelum menerapkannya di n8n
- Gabungkan templat dengan penyiapan n8n lokal Anda
Temukan Get AI Perks untuk menemukan alat bantu otomatisasi yang mendukung alur kerja n8n Anda.
Pemecahan Masalah Umum
Konflik port merupakan masalah instalasi yang paling sering terjadi. Jika port 5678 sudah digunakan, hentikan layanan yang berkonflik atau ubah port n8n menggunakan variabel lingkungan N8N_PORT.
Ketidakcocokan Versi Node
Menggunakan versi Node.js di luar rentang 20.19-24.x menyebabkan kegagalan instalasi. Repositori GitHub n8n mendokumentasikan masalah ketika pengembang mencoba lingkungan pengembangan lokal, menyoroti pentingnya kompatibilitas versi Node.
Verifikasi kompatibilitas versi Node sebelum memecahkan masalah lain. Alihkan versi Node menggunakan nvm (Node Version Manager) jika perlu.
Kesalahan Izin Volume Docker
Masalah izin dengan mount volume ~/.n8n mencegah persistensi data. Kontainer Docker berjalan sebagai pengguna node, yang mungkin tidak memiliki akses tulis ke direktori host.
Buat direktori dengan izin yang sesuai sebelum memulai kontainer:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Pertanyaan yang Sering Diajukan
Bisakah n8n berjalan tanpa akses internet?
Ya, n8n berfungsi sepenuhnya secara offline untuk alur kerja lokal. Konektivitas internet hanya diperlukan ketika alur kerja berinteraksi dengan API eksternal atau layanan cloud.
Berapa biaya menjalankan n8n secara lokal?
Instalasi lokal gratis. Edisi komunitas menyediakan semua fitur inti tanpa biaya lisensi. Hosting cloud dimulai dengan batasan eksekusi dan biaya bulanan, tetapi hosting lokal menghilangkan batasan ini sepenuhnya menurut diskusi komunitas.
Haruskah pemula menggunakan npm atau Docker?
Pemula yang menguji n8n sebaiknya memulai dengan npx untuk akses segera. Docker lebih masuk akal untuk penggunaan berkelanjutan karena memberikan isolasi yang lebih baik dan pembaruan yang lebih mudah.
Di mana n8n menyimpan data alur kerja secara lokal?
Direktori data default adalah ~/.n8n di folder home pengguna. Lokasi ini berisi file database SQLite, kredensial, dan log eksekusi kecuali dikonfigurasi sebaliknya.
Bisakah beberapa instans n8n berjalan di satu mesin?
Ya, tetapi setiap instans memerlukan port unik. Atur port yang berbeda menggunakan variabel lingkungan N8N_PORT untuk setiap instans. Docker membuatnya lebih mudah melalui pemetaan port dalam kontainer terpisah.
Bagaimana cara kerja pembaruan untuk instalasi lokal?
Instalasi npm diperbarui melalui npm update -g n8n atau npm install -g n8n@latest. Pengguna Docker menarik gambar terbaru dengan docker pull n8nio/n8n, lalu membuat ulang kontainer. Selalu cadangkan direktori ~/.n8n sebelum memperbarui.
Pertimbangan Produksi
Dokumentasi resmi n8n menekankan bahwa self-hosting memerlukan pengetahuan teknis. Menyiapkan server, mengelola sumber daya, dan mengamankan aplikasi membutuhkan pengalaman administrasi sistem.
Untuk penyebaran produksi, Docker Compose menyediakan fondasi. Tambahkan reverse proxy seperti nginx atau Caddy untuk dukungan HTTPS. Repositori n8n-hosting menyertakan konfigurasi Caddy yang siap untuk penyebaran.
Pemilihan database penting untuk beban kerja berat. Database SQLite default berfungsi untuk penggunaan moderat, tetapi PostgreSQL menawarkan kinerja yang lebih baik untuk otomatisasi bervolume tinggi menurut panduan resmi.
Membuat Pilihan: Lokal vs Cloud
Hosting n8n lokal cocok untuk tim dengan kemampuan teknis dan persyaratan keamanan spesifik. Data tetap berada di infrastruktur yang dikontrol, dan batasan eksekusi menghilang.
Namun, hosting lokal memerlukan pemeliharaan, pencadangan, dan pemantauan. Hosting cloud mentransfer tanggung jawab ini ke tim infrastruktur n8n. Periksa situs web resmi untuk perbandingan harga dan fitur cloud saat ini.
Menjalankan n8n secara lokal memberikan kontrol penuh atas infrastruktur otomatisasi alur kerja. Baik menggunakan npm untuk pengujian cepat atau Docker untuk penyebaran produksi, kedua metode memberikan platform penuh tanpa biaya berulang. Mulailah dengan npx untuk eksplorasi segera, lalu beralih ke Docker saat alur kerja bergerak menuju penggunaan produksi.
