Link Search Menu Expand Document Edit GitHub

Quick Start


Usage

To install MQTT CLI on your system please follow the Installation instructions.

The easiest way to start the CLI is by typing: mqtt See also mqtt --help.

With this you get an output on how to use MQTT CLI:

$ mqtt

Usage:  mqtt [-hV] { pub | sub | shell | test | hivemq | swarm }

MQTT Command Line Interpreter.

Options:
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.

Commands:
  pub, publish    Publish a message to a list of topics.
  sub, subscribe  Subscribe an MQTT client to a list of topics.
  shell, sh       Starts MqttCLI in shell mode, to enable interactive mode with further sub commands.
  test            Tests the specified broker on different MQTT feature support and prints the results.
  hivemq          HiveMQ Command Line Interpreter.
  swarm           HiveMQ Swarm Command Line Interpreter.

Supported Commands at Start


Basic Publish

mqtt pub -t topic -m "Hello World"

This command:

  • connects an mqtt client to a broker located on default host (localhost) and default port (1883),
  • publishes a message to a defined topic,
  • disconnects the mqtt client from the broker

See Publish for a detailed overview of the publish command


Basic Subscribe

mqtt sub -t topic

This command:

  • connects an mqtt client to a broker located on default host (localhost) and default port (1883),
  • stays connected to retrieve messages published to the given topic
  • exits and disconnects the client on Ctrl + C

See Subscribe for a detailed overview of the subscribe command


Starting the Interactive Shell

$ mqtt shell
...
mqtt>

The shell mode enables you to execute more complex MQTT behaviour - see Shell


Testing an MQTT Broker

$ mqtt test
...

This command runs a quick test suite against the broker running on the default host on the default port. The results are printed to the console.


HiveMQ Command Line

$ mqtt hivemq

Usage:  mqtt hivemq [-hV] [COMMAND]

HiveMQ Command Line Interpreter.

Options:
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.

Commands:
  export  Exports the specified details from HiveMQ

This command gives access to the HiveMQ command line which offers commands to interact with a running HiveMQ instance.


HiveMQ Swarm

The HiveMQ Swarm command offers various ways to interact with HiveMQ Swarm.

$ mqtt swarm

Usage:  mqtt swarm [-hV] [COMMAND]

HiveMQ Swarm Command Line Interpreter.

Options:
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.

Commands:
  status  Check the status of HiveMQ Swarm.
  run     HiveMQ Swarm Run Command Line Interpreter.