How to Install and Run The Aedes Broker on Node-Red

aedes-broker-imageRather than use an external broker like mosquitto with node-red you can install the Aedes node which is a MQTT broker written in node.js.

Because Aedes isn’t part of the core nodes you need to install it using the npm package manager or through the Node-red Admin control panel.

Note: Aedes replaces the Mosca broker.

Aedes Install Using Node-red Admin

In the node-red admin go to Settings and manage Pallette.


Click on the install tab and search for aedes.




After the install you should find a new node called aedes under the network categories.

Drag and drop on the Canvas to use.

Aedes Node Configuration

The node properties has two tabs connections and security,and with very few settings.

The main tab is show below:



You need to set the ports for standard MQTT and MQTT over websockets if used.

There is an option to enable SSL and if you do that then your are able to upload certificates.

You will need to upload the server.crt and the server.key files as shown in the screen shot below:


If you enable SSL then it is enabled for MQTT and MQTT over websockets, if configured. In the above screenshot the SSL port is 1883. So the possible configurations are:

  • MQTT + Websockets
  • MQTT (SSL)+ Websockets(SSL)

That means that you cannot run MQTT and MQTT(SSL) on the broker. You also need to have the MQTT port configured but websockets is an option.

The security tab contains options for username and password. These fields I understand are for the mongodb database,and you can usually leave them blank even when using the database.

The mongo database is used for persistent data and is usually as shown in the screenshot.


Note: If it appears greyed out then it is not being used.

Persistent data stores unsent messages,subscribes and retained messages so they are remembered if the server is restarted.

To use it you will need to have the mongodb server installed on your system.


Important Note: This isn’t the mongodb node. The node is a connector to a database server and not the server itself.

You will need to install the mongodb database server separately it is not a node-red node.

Testing The Install

You can use any MQTT client for testing the broker.The easiest is to use the MQTT input and output nodes.

Here is a screen shot of my test flow:


Here is the flow code which you can import into your own flow:

Video- How to Install The Mosca MQTT Broker on Node-Red


In case you are worried about performance I did a quick check using my node-red broker tester with a message rate of 100 messages/sec and it didn’t record any errors. The screenshot below show the result


Note The Aedes broker was also running on the same node-red instance as the test software.


The Node-Red Aedes node replaces the Mosca node and is useful for testing, it may also be useful for small home automation networks.

It is not really suitable for a production environment as it lacks many of the features like ACL (access control lists), authentication, message limits) that the mosquitto broker has.

However the message throughput seems to be very good.

Related Tutorials and Resources

Click to rate this post!
[Total: 0 Average: 0]


  1. Hi there , was just playing with aedes broker, i´m used to mosquitto where i make bridge connections , saw something mentioned in aedes documentation related to bridge connections but not regarding node-red .
    Is it configurable somewhere or is it not present ??

    Thank you!

  2. Handy to have a broker running on the same machine,as always looking great.
    Would be nice to have a how-to part on non mongo dabases like sqlite .i cant find any info on that.

  3. Hello Steve! I’m created an virtual machine on Oracle Cloud with Node-RED. I’m using Aedes Broker. The WS Port of Broker is set to 8888. On property Server on my MQTT IN it’s defined as “ws://PublicIP:8888/mqtt”, but I couldn’t connect with Broker Server.
    I’m tryng connect my device with Tasmota firmware to Broker Server by MQTT.

  4. Hello, all right, I’m Luciano. I created my account on the IBM cloud and created the nod-red application through it, I’m trying to make the mosquito broker mqtt work on nod-red and nothing happens. Just a question, for it to work and will I have to have a local server like respbarry pi?

        1. In my project I’m using tasmota esp8266-12E, I want to control it using IBM Cloud and Node-Red, I don’t have MQTT installed locally, I did it according to your video, but even so node-red doesn’t connect as your example.

          1. Hi
            So you have node-red with aedes installed in the cloud is that correct. I assume your esp is local is that correct. Is the problem that the esp isn’t connecting to the clod broker?

  5. There is a new MQTT broker node for Node-Red called node-red-contrib-aedes which uses aedes.js under the hood.
    Node-red-contrib-mqtt-broker was based on mosca.js which is not supported anymore. The Mosca team decided to stop the develoment and created Aedes instead.
    Have a look and let me know if it works for you.

    1. Martin
      Tks for the info. I was aware of it but haven’t looked at it for a while I will try it out.

  6. Hi, I managed to install the broker correctly thanks to this tutorial and made the test with the debug node. My only doubt is, how can I make this work with a device connected on a different network? Which address do I have to use on that case?

    1. You use the IP address of the machine running node red.Type ipconfig (windows) or ifconfig (linux) at the command line for the ip address

  7. Hi, I want to send the data of Temperature sensor from ESP8266 to node red. I am using Mosca MQTT broker in node red and using windows operating system make this thing work but due to some issue, I am not able to send the data from esp8266 to Mosca MQTT broker in Node-Red.
    Any suggestion on this will be a great help.

    1. I use RPI and Dht sensors, how can i connect the sensors to Mosca MQTT broker, and obtain data from them ?

      1. Firstly I would use the aedes broker. It replaces the mosca broker and is being updated.
        All you then need to do is to enter the broker address into the sensors and send data. You will then need a client to subscribe and read the data. You can use node-red MQTT node to do that

          1. Martin
            Sorry I don’t use those sensors so couldn’t really say but they must have some kind of configuration file.
            Can you send me the code your are using to read the values. Use the ask-steve page to send it

  8. Hello everyone!
    I made all the steps, everything is ok.
    I install the mongodb server (2.4.10), but i need help to setup the mongodb database server
    and connect to my broker.
    I don’t know how to do this, if anyone can help me!!!

    Thank you.


  9. Steve
    I have tried using Mosca on Node Red but the system crashes.
    I get an error: Uncaught exception Type error;
    “cannot set property listening or # server which has only a getter”
    then it enters a “failed state” and goes into a rebooting loop.
    I lost the entire program and had to start fresh install.
    Have you heard of any issues with Mosca?

    1. Thats what I thought but when I tested it it didn’t work that way. It did work on the mongodb database fro remote access.

Leave a Reply

Your email address will not be published. Required fields are marked *