# 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:
- Windows (EMQX Open Source only)
# 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.
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.
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.
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.
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.