Awesome Open Source
Awesome Open Source

EMQ X Broker

GitHub Release Build Status Coverage Status Docker Pulls Slack Invite Twitter Community

The best IoT MQTT open source team looks forward to your joining

English | 简体中文 | 日本語

EMQ X broker is a fully open source, highly scalable, highly available distributed MQTT messaging broker for IoT, M2M and Mobile applications that can handle tens of millions of concurrent clients.

Starting from 3.0 release, EMQ X broker fully supports MQTT V5.0 protocol specifications and backward compatible with MQTT V3.1 and V3.1.1, as well as other communication protocols such as MQTT-SN, CoAP, LwM2M, WebSocket and STOMP. The 3.0 release of the EMQ X broker can scaled to 10+ million concurrent MQTT connections on one cluster.


The EMQ X broker is cross-platform, which supports Linux, Unix, macOS and Windows. It means EMQ X can be deployed on x86_64 architecture servers and ARM devices like Raspberry Pi.

Installing via EMQ X Docker Image

docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx

Installing via Binary Package

Get the binary package of the corresponding OS from EMQ X Download page.

Build From Source

The EMQ X broker requires Erlang/OTP R21+ to build since 3.0 release.

For 4.3 and later versions.

git clone
cd emqx
_build/emqx/rel/emqx/bin console

For earlier versions, release has to be built from another repo.

git clone
cd emqx-rel
_build/emqx/rel/emqx/bin/emqx console

Quick Start

If emqx is built from source, cd _buid/emqx/rel/emqx. Or change to the installation root directory if emqx is installed from a release package.

# Start emqx
./bin/emqx start

# Check Status
./bin/emqx_ctl status

# Stop emqx
./bin/emqx stop

To view the dashboard after running, use your browser to open: http://localhost:18083


To test everything in one go

make eunit ct

To run subset of the common tests


./rebar3 ct --name '[email protected]' -c -v --dir test,apps/emqx_sn,apps/emqx_coap
./rebar3 ct --name '[email protected]' -c -v --dir apps/emqx_auth_mnesi --suite emqx_acl_mnesia_SUITE
./rebar3 ct --name '[email protected]' -c -v --dir apps/emqx_auth_mnesi --suite emqx_acl_mnesia_SUITE --case t_rest_api

NOTE: Do NOT use full (relative) path to SUITE files like this --suite apps/emqx_auth_mnesia/test/emqx_acl_mnesia_SUITE.erl, because it will lead to a full copy of apps dir into _buid/test/lib/emqx.


To Analyze all the apps
make dialyzer
To Analyse specific apps, (list of comma separated apps)
DIALYZER_ANALYSE_APP=emqx_lwm2m,emqx_auth_jwt,emqx_auth_ldap make dialyzer


Visiting EMQ X FAQ to get help of common problems.


The EMQ X Roadmap uses Github milestones to track the progress of the project.


The EMQ X community can be found on GitHub Discussions, where you can ask questions, voice ideas, and share your projects.

To chat with other community members you can join the EMQ X Slack.

MQTT Specifications

You can read the mqtt protocol via the following links:

MQTT Version 3.1.1

MQTT Version 5.0



Apache License 2.0, see LICENSE.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
erlang (794
iot (551
mqtt (298
messaging (207
pubsub (93
broker (32
lorawan (27
coap (25
mqtt-broker (19

Find Open Source By Browsing 7,000 Topics Across 59 Categories