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:

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

  1. Buka nodejs.org dan unduh versi LTS (Long Term Support) untuk Windows.
  2. Jalankan installer, klik Next sampai selesai dengan pengaturan default.
Halaman unduh Node.js versi LTS untuk instalasi Node-RED di Windows

Buka Command Prompt, lalu pastikan Node.js dan npm sudah terpasang:

node -v
npm -v
Cek versi Node.js dan npm di Command Prompt Windows

Langkah 2: Instal Node-RED

Buka Command Prompt sebagai Administrator, lalu jalankan:

npm install -g --unsafe-perm node-red
Proses instalasi Node-RED dengan npm di Windows

Langkah 3: Jalankan Node-RED

node-red
Node-RED berjalan di Command Prompt Windows

Biarkan jendela Command Prompt tetap terbuka, lalu buka browser ke alamat http://localhost:1880. Editor Node-RED akan tampil:

Tampilan editor Node-RED di browser pada localhost:1880

Bagian 2 – Instal Mosquitto MQTT Broker di Windows

  1. Buka mosquitto.org/download.
  2. Pada bagian Windows, unduh installer 64-bit (mosquitto-x.x.x-install-windows-x64.exe).
  3. Jalankan installer. Pastikan komponen Service tercentang agar Mosquitto berjalan otomatis saat Windows menyala.
  4. Selesaikan instalasi. Secara default Mosquitto terpasang di C:\Program Files\mosquitto.
Halaman unduh Mosquitto MQTT broker untuk Windows
Unduh installer Mosquitto Windows dari mosquitto.org
Langkah instalasi Mosquitto di Windows
Pilihan komponen Mosquitto Service saat instalasi di Windows
Instalasi Mosquitto MQTT broker di Windows selesai

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.conf

Tambahkan 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 true

Versi 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 mosquitto

Terakhir, 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=1883

Keamanan: 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.

  1. Di editor Node-RED, tarik node inject, mqtt out, mqtt in, dan debug ke workspace.
  2. Klik dua kali node mqtt out, tambahkan server baru: Server localhost, Port 1883. Isi Topic test/node-red.
  3. Atur node mqtt in dengan server yang sama dan Topic test/node-red.
  4. Hubungkan inject → mqtt out dan mqtt in → debug, lalu klik Deploy. Status node harus connected.
  5. Klik tombol pada node inject. Pesan akan muncul di panel Debug — artinya Node-RED sudah terhubung ke Mosquitto.

Troubleshooting Instalasi Node-RED dan Mosquitto

GejalaPenyebabSolusi
node-red tidak dikenaliNode.js belum terpasang atau PATH belum diperbaruiTutup lalu buka ulang Command Prompt; cek node -v
mosquitto_sub tidak dikenaliTidak berada di folder MosquittoJalankan dari C:\Program Files\mosquitto atau tambahkan folder itu ke PATH
ESP32 gagal connect (state -2)Broker hanya mendengarkan localhost atau diblokir firewallPakai listener 1883 tanpa localhost, buka port 1883 di firewall
Connection refused: not authorisedListener aktif tetapi login diwajibkanTambahkan allow_anonymous true atau gunakan username/password
Perubahan config tidak berpengaruhService belum di-restartnet stop mosquitto lalu net start mosquitto

Tugas Praktikum Setelah Instalasi Node-RED dan Mosquitto

  1. Buat flow Node-RED yang mengirim angka acak ke topik lab/sensor setiap 5 detik, lalu tampilkan di node debug.
  2. Hubungkan ESP32 ke broker ini dan kirim data sensor — ikuti tutorial MQTT ESP32.
  3. 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

Related Articles

Tinggalkan Balasan

Chat Langsung dengan Kami
Staff bisaioti 1 — +62 823-3306-4821 E-Course, Offline Course, Hardware & Teknis IoT/OT Staff bisaioti 2 — +62 823-3306-4821 Training Korporat & Toko Hardware