Instalasi Node-RED dan Mosquitto MQTT Broker di Windows (Langkah demi Langkah)

Instalasi Node-RED dan Mosquitto di Windows adalah langkah pertama sebelum membangun proyek IoT berbasis MQTT: Mosquitto berperan sebagai broker (perantara pesan), sedangkan Node-RED dipakai untuk mengolah dan menampilkan data. Panduan ini membahas langkah demi langkah — mulai dari Node.js, Node-RED, Mosquitto, konfigurasi agar ESP32 bisa terhubung, hingga uji koneksi — untuk Windows 10 dan 11.
Daftar isi:
- Bagian 1: Instal Node.js dan Node-RED
- Bagian 2: Instal Mosquitto MQTT broker
- Bagian 3: Konfigurasi mosquitto.conf
- Bagian 4: Uji Mosquitto
- Bagian 5: Hubungkan Node-RED ke Mosquitto
- Troubleshooting
Tujuan dan Persiapan Instalasi Node-RED dan Mosquitto
- Menginstal dan menjalankan Node-RED di Windows.
- Menginstal dan mengonfigurasi Mosquitto MQTT broker agar bisa diakses perangkat lain (ESP32, Raspberry Pi, HP).
- Menghubungkan Node-RED dengan Mosquitto dan menguji publish/subscribe.
Yang dibutuhkan: laptop/PC Windows 10/11, koneksi internet, dan hak administrator untuk instalasi.
Bagian 1 – Instal Node.js dan Node-RED di Windows
Langkah 1: Instal Node.js
- Buka nodejs.org dan unduh versi LTS (Long Term Support) untuk Windows.
- Jalankan installer, klik Next sampai selesai dengan pengaturan default.

Buka Command Prompt, lalu pastikan Node.js dan npm sudah terpasang:
node -v
npm -v
Langkah 2: Instal Node-RED
Buka Command Prompt sebagai Administrator, lalu jalankan:
npm install -g --unsafe-perm node-red
Langkah 3: Jalankan Node-RED
node-red
Biarkan jendela Command Prompt tetap terbuka, lalu buka browser ke alamat http://localhost:1880. Editor Node-RED akan tampil:

Bagian 2 – Instal Mosquitto MQTT Broker di Windows
- Buka mosquitto.org/download.
- Pada bagian Windows, unduh installer 64-bit (
mosquitto-x.x.x-install-windows-x64.exe). - Jalankan installer. Pastikan komponen Service tercentang agar Mosquitto berjalan otomatis saat Windows menyala.
- Selesaikan instalasi. Secara default Mosquitto terpasang di
C:\Program Files\mosquitto.





Bagian 3 – Konfigurasi mosquitto.conf agar Bisa Diakses ESP32
Sejak Mosquitto 2.0, tanpa konfigurasi broker hanya menerima koneksi dari komputer itu sendiri (localhost). Agar ESP32 atau perangkat lain di jaringan yang sama bisa terhubung, edit file berikut dengan Notepad/Notepad++ yang dijalankan sebagai Administrator:
C:\Program Files\mosquitto\mosquitto.confTambahkan konfigurasi berikut di bagian paling bawah:
# Port MQTT standar - terbuka untuk semua perangkat di jaringan
listener 1883
# Port MQTT over WebSocket (untuk aplikasi web / browser)
listener 9001
protocol websockets
# Izinkan koneksi tanpa login (hanya untuk belajar di jaringan lokal)
allow_anonymous trueVersi lama panduan ini memakai listener 1883 localhost. Dengan tambahan localhost, broker hanya menerima koneksi dari komputer itu sendiri sehingga ESP32 tidak bisa terhubung. Hapus kata localhost jika broker akan diakses perangkat lain.
Simpan file, lalu restart layanan Mosquitto lewat Command Prompt (Administrator):
net stop mosquitto
net start mosquittoTerakhir, izinkan port 1883 di Windows Firewall agar perangkat lain bisa masuk:
netsh advfirewall firewall add rule name="Mosquitto MQTT" dir=in action=allow protocol=TCP localport=1883Keamanan: allow_anonymous true hanya cocok untuk belajar. Untuk penggunaan nyata, buat user dengan mosquitto_passwd -c "C:\Program Files\mosquitto\passwd" nama_user, lalu ganti konfigurasi menjadi allow_anonymous false dan password_file C:\Program Files\mosquitto\passwd.
Bagian 4 – Uji Mosquitto dengan mosquitto_sub dan mosquitto_pub
Buka dua jendela Command Prompt dan masuk ke folder Mosquitto:
cd "C:\Program Files\mosquitto"
:: Jendela 1 - subscribe
mosquitto_sub -h localhost -t "test/topik" -v
:: Jendela 2 - publish
mosquitto_pub -h localhost -t "test/topik" -m "Halo dari Mosquitto"Jika Jendela 1 menampilkan test/topik Halo dari Mosquitto, broker sudah berjalan. Untuk memastikan perangkat lain bisa terhubung, ganti localhost dengan IP komputer (cek dengan perintah ipconfig, misalnya 192.168.1.5). Jika perlu menjalankan broker secara manual dengan log, hentikan service lalu jalankan mosquitto -c mosquitto.conf -v dari folder yang sama.
Bagian 5 – Menghubungkan Node-RED dengan Mosquitto Setelah Instalasi
Node mqtt in dan mqtt out sudah tersedia bawaan di Node-RED, jadi tidak perlu menginstal paket tambahan.
- Di editor Node-RED, tarik node inject, mqtt out, mqtt in, dan debug ke workspace.
- Klik dua kali node mqtt out, tambahkan server baru: Server
localhost, Port1883. Isi Topictest/node-red. - Atur node mqtt in dengan server yang sama dan Topic
test/node-red. - Hubungkan inject → mqtt out dan mqtt in → debug, lalu klik Deploy. Status node harus connected.
- Klik tombol pada node inject. Pesan akan muncul di panel Debug — artinya Node-RED sudah terhubung ke Mosquitto.
Troubleshooting Instalasi Node-RED dan Mosquitto
| Gejala | Penyebab | Solusi |
|---|---|---|
node-red tidak dikenali | Node.js belum terpasang atau PATH belum diperbarui | Tutup lalu buka ulang Command Prompt; cek node -v |
mosquitto_sub tidak dikenali | Tidak berada di folder Mosquitto | Jalankan dari C:\Program Files\mosquitto atau tambahkan folder itu ke PATH |
| ESP32 gagal connect (state -2) | Broker hanya mendengarkan localhost atau diblokir firewall | Pakai listener 1883 tanpa localhost, buka port 1883 di firewall |
Connection refused: not authorised | Listener aktif tetapi login diwajibkan | Tambahkan allow_anonymous true atau gunakan username/password |
| Perubahan config tidak berpengaruh | Service belum di-restart | net stop mosquitto lalu net start mosquitto |
Tugas Praktikum Setelah Instalasi Node-RED dan Mosquitto
- Buat flow Node-RED yang mengirim angka acak ke topik
lab/sensorsetiap 5 detik, lalu tampilkan di node debug. - Hubungkan ESP32 ke broker ini dan kirim data sensor — ikuti tutorial MQTT ESP32.
- Tampilkan data sensor di dashboard — ikuti tutorial ESP32 DHT11 Node-RED.
Kesimpulan
Node-RED dan Mosquitto kini sudah terpasang di Windows dan siap dipakai untuk proyek IoT. Langkah berikutnya: pelajari konsep dasarnya di panduan protokol MQTT, coba MQTT dengan Python, atau hubungkan perangkat nyata seperti ESP32. Untuk belajar lebih terarah, ikuti Training IoT Profesional bisaioti. Pengguna Raspberry Pi atau Linux dapat membaca panduan instalasi Mosquitto dan Node-RED di Raspberry Pi.
Referensi
- Node-RED, “Running on Windows” – nodered.org
- Eclipse Mosquitto, “Download” – mosquitto.org
- Eclipse Mosquitto, “mosquitto.conf man page” – mosquitto.org




