Cara Install Node-RED di Windows, Raspberry Pi / Orange Pi, dan Docker

Jobsheet: Cara Install Node-RED di Windows dan Linux

Tujuan

Peserta dapat menginstal dan menjalankan Node-RED pada sistem operasi Windows dan Linux.

Teori

Node-RED adalah platform pengembangan berbasis alur kerja (flow-based programming) yang digunakan untuk menghubungkan perangkat keras, API, dan layanan online dengan mudah. Dikembangkan oleh IBM, Node-RED menggunakan antarmuka drag-and-drop berbasis browser untuk membuat dan mengelola alur data (flows) secara visual. Platform ini sangat populer dalam otomasi industri, IoT, dan integrasi sistem karena fleksibilitasnya dalam menghubungkan berbagai protokol komunikasi seperti MQTT, Modbus, dan REST API.

Peralatan yang Dibutuhkan

1. Komputer dengan sistem operasi Windows atau Linux.
2. Koneksi internet yang stabil.
3. Aplikasi terminal (Linux) atau Command Prompt (Windows).
4. Node.js dan npm (Node Package Manager).

Bagian 1: Instalasi Node-RED di Windows

Langkah 1: Unduh dan Instal Node.js

1. Buka situs resmi Node.js: https://nodejs.org/.
2. Unduh versi LTS (Long-Term Support).
3. Jalankan file installer Node.js yang telah diunduh.
4. Ikuti petunjuk instalasi hingga selesai. Pilih opsi untuk menginstal npm juga.

Langkah 2: Verifikasi Instalasi Node.js dan npm

• Buka Command Prompt (CMD) dan ketik:

node -v

npm -v

• Pastikan Node.js ≥ 14.x dan npm ≥ 6.x terinstal.

Langkah 3: Instal Node-RED

• Instal Node-RED menggunakan npm:

npm install -g --unsafe-perm node-red

• Tunggu hingga proses instalasi selesai.

Langkah 4: Menjalankan Node-RED

• Ketik perintah berikut di CMD:

node-red

1. Catat alamat URL untuk mengakses Node-RED (biasanya http://127.0.0.1:1880).
2. Buka browser dan masukkan URL tersebut.

Bagian 2: Instalasi Node-RED di Linux

Langkah 1: Update Sistem Operasi

1. Buka terminal.
2. Jalankan perintah berikut untuk memperbarui sistem:

sudo apt update && sudo apt upgrade -y

Langkah 2: Instal Node.js dan npm

Cara simple bisa seperti dibawah ini :

bash <(curl -sL https://raw.githubusercontent.com/nodered/linux-installers/master/deb/update-nodejs-and-nodered)

jika terdapar error bisa dengan cara dibawah ini

node-red admin init

atau bisa juga menggunakan cara seperti dibawah ini :

• Instal Node.js (gunakan versi stabil):

sudo apt install nodejs -y

• Instal npm (Node Package Manager):

sudo apt install npm -y

• Verifikasi instalasi Node.js dan npm:

node -v

npm -v

1. • Pastikan Node.js ≥ 14.x dan npm ≥ 6.x terinstal.

Langkah 3: Instal Node-RED

• Jalankan perintah berikut untuk menginstal Node-RED:

sudo npm install -g --unsafe-perm node-red

• Tunggu hingga instalasi selesai.

Langkah 4: Menjalankan Node-RED

• Jalankan Node-RED dengan perintah:

node-red

1. Catat URL untuk mengakses dashboard Node-RED (http://127.0.0.1:1880).
2. Buka URL tersebut di browser.

Langkah 5: Konfigurasi Autostart (Opsional)

• Buat file service Node-RED:

sudo nano /etc/systemd/system/node-red.service

• Tambahkan konfigurasi berikut:

[Unit]

Description=Node-RED

After=network.target




[Service]

ExecStart=/usr/bin/env node-red

Restart=on-failure

User=your-username

Group=your-group

Environment="PATH=/usr/bin:/usr/local/bin"




[Install]

WantedBy=multi-user.target

1. • Ganti your-username dengan username Anda.
2. Simpan file dengan menekan CTRL+O, lalu keluar dengan CTRL+X.
3. Aktifkan service:

sudo systemctl enable node-red

• Jalankan service:

sudo systemctl start node-red

Troubleshooting

1. Node-RED Tidak Berjalan:
   • Periksa log di terminal atau CMD untuk mengetahui error.
   • Pastikan Node.js dan npm terinstal dengan benar.
2. Port 1880 Sudah Digunakan:
   • Jalankan Node-RED dengan port lain:

node-red -p 1881

1. Node Tambahan Tidak Terlihat:
   • Jalankan perintah berikut di folder ~/.node-red:

npm rebuild

Luaran

• Node-RED berhasil diinstal pada sistem operasi Windows atau Linux.
• Dashboard Node-RED dapat diakses melalui browser dan digunakan untuk membangun flow diagram.

Troubleshooting

Jika versi node kurang dari 18 berikut langkah-langkahnya.

• sudo apt-get remove nodejs
• curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash –
• sudo apt-get install nodejs

jika langkah pada diatas masih error lakukan langkah berikut ini :

1. Hapus Paket Lama (libnode-dev)

Hapus paket libnode-dev yang menjadi sumber konflik:

sudo apt remove libnode-dev

Jika Anda tidak yakin apakah ingin menghapus paket tersebut karena aplikasi lain bergantung pada paket ini, pertimbangkan untuk membuat cadangan terlebih dahulu.

2. Bersihkan Cache APT

Bersihkan file instalasi .deb yang mungkin rusak atau masih ada di cache:

sudo apt clean

sudo apt autoremove

3. Coba Instal Ulang Node.js

Coba instal ulang Node.js setelah membersihkan konflik:

sudo apt update

sudo apt install -y nodejs

4. Paksa Instalasi Node.js

Jika konflik masih terjadi, Anda bisa memaksa instalasi Node.js dengan menimpa file yang sudah ada. Gunakan perintah berikut (hati-hati karena ini akan menimpa file):

sudo dpkg -i --force-overwrite /var/cache/apt/archives/nodejs_18.20.5-1nodesource1_arm64.deb

Setelah itu, jalankan:

sudo apt --fix-broken install

5. Verifikasi Instalasi

Periksa apakah Node.js sudah terinstal dengan benar:

node -v

npm -v

6. Gunakan n (Opsional)

Jika metode di atas tidak berhasil, Anda dapat menginstal Node.js menggunakan manajer versi seperti n:

sudo npm install -g n

sudo n lts

 

Baca Juga

• Belajar Raspberry Pi: Panduan Lengkap dari Instalasi hingga IoT

Instalasi via Docker

Docker adalah pilihan terbaik jika Anda menginginkan environment yang konsisten, mudah dipindahkan antar server, dan mudah di-backup/restore. Cocok untuk instalasi di server industri atau ketika mengelola beberapa instance Node-RED sekaligus.Jalankan Node-RED sebagai container dengan satu baris perintah:

docker run -d -p 1880:1880 -v node_red_data:/data --name mynodered nodered/node-red

Perintah di atas akan menjalankan Node-RED di background (-d), memetakan port 1880, dan menyimpan data flow di volume node_red_data supaya konfigurasi tidak hilang saat container di-restart atau diperbarui.Untuk melihat status container:

docker ps

Memilih Metode Instalasi yang Tepat

• Raspberry Pi — pilihan terbaik untuk deployment lapangan/produksi berbiaya rendah, terutama proyek pilot atau fasilitas kecil-menengah.
• Windows — cocok untuk development, testing, atau workstation operator yang sudah punya PC Windows.
• Docker — ideal untuk server produksi yang butuh reliability, kemudahan backup, dan pengelolaan multiple instance.

Konfigurasi Awal Setelah Instalasi

Setelah Node-RED berhasil diinstall dan diakses, ada beberapa langkah konfigurasi awal yang disarankan:

• Amankan editor dengan login — tambahkan autentikasi username/password di file settings.js supaya editor tidak bisa diakses sembarang orang, terutama jika Node-RED terhubung ke jaringan produksi.
• Install node tambahan yang dibutuhkan — misalnya @flowfuse/node-red-dashboard (Dashboard 2.0) untuk visualisasi, atau node-red-contrib-modbus untuk komunikasi Modbus, melalui menu Manage Palette di editor.
• Backup folder .node-red secara berkala — folder ini menyimpan semua flow dan konfigurasi Anda.

Dengan Node-RED terinstall dan siap digunakan, langkah berikutnya dalam seri ini adalah menghubungkannya ke perangkat industri via Modbus RTU — dibahas lengkap di artikel selanjutnya.

Menjalankan Node-RED sebagai Service Otomatis (systemd)

Selain menjalankan Node-RED secara manual lewat terminal, sebaiknya Node-RED dikonfigurasi agar otomatis berjalan setiap kali Raspberry Pi atau server Linux dinyalakan ulang. Oleh karena itu, gunakan systemd agar Node-RED tetap aktif meski terjadi restart mendadak akibat listrik padam, yang cukup umum terjadi di lingkungan pabrik.Pada Raspberry Pi OS, paket instalasi resmi biasanya sudah menyertakan service nodered.service. Aktifkan dengan perintah berikut:

sudo systemctl enable nodered.service
sudo systemctl start nodered.service
sudo systemctl status nodered.service

Dengan demikian, jika Raspberry Pi mati mendadak dan menyala kembali, Node-RED akan otomatis aktif tanpa perlu login dan menjalankan perintah secara manual. Selanjutnya, cek log service dengan journalctl -u nodered -f apabila Node-RED gagal start, agar penyebabnya bisa segera diketahui.

Tips Keamanan Dasar Node-RED di Jaringan Industri

Karena Node-RED sering terhubung langsung ke perangkat produksi seperti PLC dan sensor, keamanan editor dan flow menjadi hal yang tidak boleh diabaikan. Berikut beberapa langkah dasar yang sebaiknya diterapkan sejak awal instalasi:

• Aktifkan HTTPS — gunakan sertifikat SSL (self-signed untuk jaringan internal, atau Let’s Encrypt jika diakses dari internet) agar traffic ke editor tidak dikirim dalam bentuk plain text.
• Batasi akses jaringan — misalnya melalui firewall atau VLAN terpisah, sehingga port editor Node-RED (default 1880) tidak bisa diakses sembarangan dari luar jaringan pabrik.
• Update Node-RED dan Node.js secara berkala — versi lama berpotensi memiliki celah keamanan yang sudah diperbaiki di rilis terbaru.
• Nonaktifkan node yang tidak digunakan — semakin sedikit node pihak ketiga yang terinstall, semakin kecil permukaan serangan (attack surface) yang perlu diamankan.

Dengan kombinasi autentikasi editor, HTTPS, dan pembatasan akses jaringan, Node-RED dapat digunakan dengan lebih aman sebagai jembatan antara perangkat OT dan sistem monitoring/IT di level pabrik.

Cara Update dan Uninstall Node-RED

Selain instalasi awal, penting juga mengetahui cara memperbarui Node-RED ke versi terbaru serta cara menghapusnya jika suatu saat diperlukan. Sebagai contoh, di Raspberry Pi/Linux, update dilakukan dengan menjalankan ulang script instalasi resmi:

bash <(curl -sL https://raw.githubusercontent.com/node-red/linux-installers/master/deb/update-nodejs-and-nodered)

Skrip ini akan memperbarui Node.js dan Node-RED sekaligus tanpa menghapus flow yang sudah tersimpan di folder .node-red. Namun demikian, tetap disarankan membuat backup terlebih dahulu sebelum melakukan update besar, terutama jika versi Node.js yang digunakan berubah signifikan.Apabila Node-RED perlu dihapus sepenuhnya, misalnya karena server dipindah ke Docker, jalankan perintah uninstall resmi atau cukup hapus folder instalasi npm global-nya beserta folder .node-red. Untuk instalasi via Docker, cukup hentikan dan hapus container serta volume terkait menggunakan docker compose down -v.