# Getting Started

EMQX is the world’s most scalable and reliable MQTT messaging platform that can help you to connect, move and process your business data reliably in real-time. With this all-in-one MQTT platform, you can easily build your Internet of Things (IoT) applications with significant business impacts.

This chapter will give you a tour of how to download and install EMQX and how to test the connecting and messaging services with our built-in WebSocket tool.


Besides the deployment methods introduced in this quickstart guide, you are also welcome to try our EMQX Cloud (opens new window), a fully managed MQTT service for IoT. You will only need to register for an account (opens new window) before you can start your MQTT services and connect your IoT devices to any cloud with zero need for infrastructure maintenance.

# Select your EMQX edition

EMQX is available in open source and Enterprise editions, you may click the link below to download the edition as your business needs.

# Install EMQX

EMQX can be run with Docker, installed with EMQX Kubernetes Operator (opens new window), or installed on a computer or virtual machine (VM) via a download package. If you choose to install EMQX with a download package, the following operating systems are currently supported:

  • RedHat
  • CentOS
  • RockyLinux
  • AmazonLinux
  • Ubuntu
  • Debian
  • macOS
  • Linux
  • Windows (EMQX Open Source only)

For other platforms not listed above, you can try to build and install with source code or simply contact EMQ (opens new window) for support.

In addition, you can also deploy EMQX with one click through EMQX Terraform (opens new window) on the cloud, for example, Alibaba Cloud (opens new window) and AWS (opens new window).

# Install EMQX with Docker/installation package

In this quick start guide, we will show you the easiest ways to start or run EMQX, that is, with Docker or with the installation package.

Now that we have successfully started EMQX, we can continue to test the connection and message services with the built-in Dashboard WebSocket tool.

# Use Dashboard WebSocket to verify the connection

EMQX supports standard MQTT protocols, including MQTT over WebSocket. After startup, you can directly connect your MQTT clients to EMQX. In this section, we will illustrate how to use the Dashboard WebSocket tool to connect EMQX to verify the messaging services.

In the Dashboard page, click Diagnose -> WebSocket Client on the left navigation bar to access the WebSocket Client page. Then we can connect the client with EMQX, subscribe to certain topics, and verify the messaging services.

  1. Connect the client with EMQX. Click the Connect button on the right side of the screen, and you will be prompted that the connection is successfully established.

  2. Subscribe to topics: Click the Subscribe button in the middle of the screen, and we will be subscribed to all messages under topic testtopic/# with QoS 0. You can continue to subscribe to more topics and test other QoS levels.

  3. Test the messaging services: Click the Publish button at the bottom of the screen, and we can see a new message appear in both the Received and Published dialog box, indicating the connection is successfully established.

  4. Then we can click Dashboard in the left navigation tree to return to the Dashboard page, we can check metrics such as Connections, Topics, Subscriptions, Incoming Messages, Outgoing messages, and Dropped Messages.

If you'd like to continue the testing, such as one-way/two-way SSL authentication and simulate test data with customized scripts, you can continue to explore with our MQTT X (opens new window), a cross-platform MQTT desktop client.

# Advanced operation

So far, we have completed the installation, startup, and access test of EMQX, you can continue to try out more advanced capabilities of EMQX, such as authentication and integration with third-party data systems.

# Contact us

If you have any questions on the use of EMQX or EMQ products, you are warmly welcome to contact us (opens new window) for professional support.