Go to file

tigercl 8f5a0a8cbd Merge pull request #3043 from emqx/master Auto-pull-request-by-2019-11-18		2019-11-18 17:27:23 +08:00
.github	TEMPLATE	2016-11-10 17:26:02 +08:00
etc	Fix test cases and update certs	2019-11-18 16:08:51 +08:00
include	Update record banned	2019-11-15 14:55:14 +08:00
priv	Add 'active_n' option for WebSocket listener	2019-11-01 08:00:11 +08:00
scripts	Move test/run_emqx.escript -> scripts/run_emqx.escript	2019-08-03 14:08:20 +08:00
src	Fix the check of limiter	2019-11-18 11:51:58 +08:00
test	Fix test cases and update certs	2019-11-18 16:08:51 +08:00
.editorconfig	add editorconfig for emqx	2018-09-03 14:03:20 +08:00
.gitignore	Optimize develop workflow and support make run and code hot swapping (#2644 )	2019-06-21 20:52:27 +08:00
.travis.yml	Add more test cases (#2992 )	2019-10-24 15:41:26 +08:00
LICENSE	Licensed under the Apache, Version 2.0	2016-02-05 14:26:17 +08:00
Makefile	Add more test cases (#2992 )	2019-10-24 15:41:26 +08:00
README-CN.md	Add reddit community link to README	2019-11-14 17:13:44 +08:00
README.md	Merge remote-tracking branch 'origin/develop'	2019-11-18 08:55:26 +00:00
rebar.config	Upgrade deps to ekka v0.7.1	2019-11-18 11:01:30 +08:00
rebar.config.script	Build with rebar3 (#2475 )	2019-04-28 09:40:39 +08:00
vars	Restore app.confg rule in makefile for debug and test	2019-05-08 21:18:24 +08:00

README.md

EMQ X Broker

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.

For full list of new features, please read EMQ X Release Notes.
For more information, please visit EMQ X homepage.

Installation

The EMQ X broker is cross-platform, which supports Linux, Unix, Mac OS 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

Or download the binary package for your platform from here.

Build From Source

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

git clone https://github.com/emqx/emqx-rel.git

cd emqx-rel && make

cd _build/emqx/rel/emqx && ./bin/emqx console

Quick Start

# 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

FAQ

Visiting FAQ to get help of common problems.

Roadmap

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

Community, discussion, contribution, and support

You can reach the EMQ community and developers via the following channels:

Please submit any bugs, issues, and feature requests to emqx/emqx.

MQTT Specifications

You can read the mqtt protocol via the following links:

MQTT Version 3.1.1

MQTT Version 5.0

MQTT SN

License

Apache License 2.0, see LICENSE.