Installation
Prerequisites
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.
Docker
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
Homebrew
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 usebrew 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
127.0.0.1 localhost your-pc-name
specified under/etc/hosts
. You can usesudo sh -c "echo 127.0.0.1 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
:
wget https://github.com/hivemq/mqtt-cli/releases/download/v4.8.2/mqtt-cli-4.8.2.deb
sudo apt install ./mqtt-cli-4.8.2.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 https://github.com/hivemq/mqtt-cli/releases/download/v4.8.2/mqtt-cli-4.8.2.rpm
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