MQTT X CLI supports Windows, macOS, and Linux. You can install MQTT X CLI in the following ways:

  1. Quick installation using command line download binaries

  2. Install with Docker

  3. Using NPM

  4. Alternative, you can download and install manually from the MQTT X CLI homepage or from GitHub

If you encounter network issues that cause slow or stuck downloads from GitHub, we recommend that you download and install from MQTT X CLI homepage.

If you need to download and use more released versions, you can also check out More Downloads, choose the version that meets your needs, and install it.

Note: When downloading, pay attention to distinguish the CPU architecture of the current system environment, and try to choose the latest version to download.



brew install emqx/mqttx/mqttx-cli

Intel Chip

curl -LO
sudo install ./mqttx-cli-macos-x64 /usr/local/bin/mqttx

Apple Silicon

curl -LO
sudo install ./mqttx-cli-macos-arm64 /usr/local/bin/mqttx



curl -LO
sudo install ./mqttx-cli-linux-x64 /usr/local/bin/mqttx


curl -LO
sudo install ./mqttx-cli-linux-arm64 /usr/local/bin/mqttx


For Windows users, please go to the MQTT X CLI home page or GitHub and find the exe package for the corresponding system architecture, download it manually and use it.


docker pull emqx/mqttx-cli

docker run -it --rm emqx/mqttx-cli


npm install mqttx-cli -g

Other platforms

Download packaged binaries from the MQTT X releases page.

Verify installation

After installation, you can verify that the installation is successful by running the following command:

mqttx -v