Skip to content

Experience RobustMQ MQTT

Prerequisite: Start the Broker

Follow the Quick Install guide to install RobustMQ, then start the service:

bash
robust-server start

Verify the broker is running:

bash
robust-ctl status

Choose an MQTT Client

Use either of the following to test MQTT publish and subscribe.

Option 1: MQTTX CLI

MQTTX CLI is an open-source MQTT command-line client by EMQ. See the installation guide at: https://mqttx.app/zh/docs/cli

Once installed, the mqttx command is available.

Option 2: robust-bench (built-in)

robust-bench is RobustMQ's built-in benchmarking tool — no extra installation needed. See the full usage guide: Bench CLI Documentation


Publish and Subscribe

Using MQTTX

Open two terminals and run:

bash
# Terminal 1: Subscribe
mqttx sub -h localhost -p 1883 -t "test/topic"

# Terminal 2: Publish
mqttx pub -h localhost -p 1883 -t "test/topic" -m "Hello RobustMQ!"

If the subscriber receives the message, MQTT is working correctly.

Common options:

bash
# Specify QoS
mqttx pub -h localhost -p 1883 -t "test/qos1" -m "msg" -q 1

# Publish a retained message
mqttx pub -h localhost -p 1883 -t "test/retained" -m "retained msg" -r

# Wildcard subscription
mqttx sub -h localhost -p 1883 -t "test/#"

Using robust-bench

bash
# Connection benchmark (establish 100 connections)
robust-bench mqtt conn --count 100

# Publish benchmark (100 clients, 30 seconds)
robust-bench mqtt pub --count 100 --duration-secs 30

# Subscribe benchmark (100 clients)
robust-bench mqtt sub --count 100 --duration-secs 30

For more options see the Bench CLI Documentation.