Link Search Menu Expand Document Edit GitHub



At least Java 8 is required to run MQTT CLI.

The CLI is implemented with Java 11 which is the preferred version to run this project.


You can run MQTT-CLI on every OS which supports Docker. To execute a simple command use the following syntax:

docker run hivemq/mqtt-cli <your-command>

To start the Shell-Mode of the CLI you need to add the -it flags to the docker-command:

docker run -it hivemq/mqtt-cli shell


For Mac OS X and Linux systems use Homebrew to install MQTT CLI via the MQTT CLI Tap.

$ brew install hivemq/mqtt-cli/mqtt-cli

NOTE: If you encounter an error like Java 1.8+ is required to install this formula please install a java version higher than 1.8. You can use brew cask install adoptopenjdk to install the latest release of adoptopenjdk.

NOTE: As latency-issues may slow down the CLI under Mac OS X please verify that you have the entry localhost your-pc-name specified under /etc/hosts. You can use sudo sh -c "echo localhost $(hostname) >> /etc/hosts" to append this configuration to your hosts file.

Windows Zip

Download the Windows Zipfile and extract it in your preferred location. To execute MQTT CLI simply open the Windows Command Prompt with ⊞ Win + R and execute cmd. Navigate into the extracted MQTT CLI folder and execute mqtt-cli.exe.

To quick start the shell simply double-click the mqtt-cli-shell.cmd file.

Debian Package

If you are using a *nix operating system which operates with debian packages you can download the MQTT CLI debian package from the releases page via wget or curl and install the package with sudo dpkg -i or sudo apt install:

sudo apt install ./mqtt-cli-4.9.1.deb

RPM Package

For Red Hat, Fedora, Mandriva, OpenSuse, CentOS distributions you can use the rpm package provided at releases page. The preferred way is to install the package via the yum package manager. To install the package simply execute:

sudo yum install -y

Building from source

The MQTT CLI project uses Gradle to build. A gradle wrapper configuration is included, so that after cloning the repository from GitHub, you can simply change into the directory containing the project and execute

./gradlew build