Node-RED: Connecting to MQTT via WebSockets

This documentation is part of the MQTT server guide. View the full guide here: How to connect Node-RED to Mosquitto MQTT server.

👋 Welcome to the Stackhero documentation!

Stackhero offers a ready-to-use Node-RED cloud solution that provides a host of benefits, including:

• MQTT server included (Mosquitto).
• Full access to Node-RED admin UI.
• Node-RED Dashboard included.
• Unlimited and dedicated SMTP email server included.
• Effortless updates with just a click.
• Customizable domain name secured with HTTPS (for example, https://node-red.your-company.com).
• Optimal performance and robust security powered by a private and dedicated VM.

Save time and simplify your life: it only takes 5 minutes to try Stackhero's Node-RED cloud hosting solution!

You have the flexibility to connect to the Mosquitto MQTT server using either the MQTT protocol or WebSockets.

While the MQTT protocol is lightweight, making it a great fit for IoT devices, it is not natively supported in web browsers. If you want to interact with your MQTT server from a browser, you will want to use WebSockets. This approach lets you encapsulate MQTT traffic within the WebSocket protocol, and it works seamlessly with Stackhero's services.

To enable WebSocket connectivity, simply activate the "WebSocket Support" option in your Stackhero dashboard. Once enabled, you can configure your client to use the WebSocket URL: wss://<XXXXXX>.stackhero-network.com:443/mqtt. Make sure to substitute the default mqtts://<XXXXXX>.stackhero-network.com with this WebSocket URL for browser-based connections.

Choosing an MQTT library

For development, you might find the "MQTT.js" library especially helpful. It is a robust JavaScript library compatible with both Node.js and browser environments. You can learn more by checking out its official repository.

Browser-to-MQTT connection example via WebSockets

If you are looking for a practical example of how to connect from your browser to the MQTT server using WebSockets, you can refer to this repository: https://github.com/stackhero-io/mqttWebSocketGettingStarted. Feel free to modify the src/index.html file with your server's url, username, and password to fit your setup.

MQTT WebSocket example

Before you try this setup, make sure that WebSocket support is enabled in your Stackhero dashboard. This ensures everything runs smoothly for browser-based connections.