create emqx project

Feng Lee 18e7de8e0f Merge branch 'master' of github.com:emqtt/emqtt 10 years ago
apps 38051426fa user 10 years ago
deps 3a6ed9a876 0.2 project structure 11 years ago
doc b17e7715ff 3.1.1 spec 10 years ago
plugins 21f5d730d9 rm placeholder 10 years ago
rel 48e893c016 Merge branch 'master' of github.com:emqtt/emqttd 10 years ago
tests 68eb225981 add tests 11 years ago
.gitignore e6db7c7854 add spec 11 years ago
.gitmodules 68eb225981 add tests 11 years ago
.travis.yml db6d9cc49b add 11 years ago
CHANGELOG.md aae3258beb 0.7.1 10 years ago
LICENSE f33cf11cd5 emqtt.io 10 years ago
Makefile 409b5dbe42 copy plugins... 10 years ago
README.md e62dec7d56 huangdan 10 years ago
TODO 11d19c1745 0.7.0 release 10 years ago
go 7359f4ffa1 fix go script 11 years ago
rebar 2d2aa2f79a upgrade esockd, mochiweb 11 years ago
rebar.config 4d89ec1ed5 fix issue #102 - 'make clean' cannot work 10 years ago

README.md

Overview Build Status

emqttd is a massively scalable and clusterable MQTT V3.1/V3.1.1 broker written in Erlang/OTP. emqttd support both MQTT V3.1/V3.1.1 protocol specification with extended features.

emqttd requires Erlang R17+ to build.

Goals

emqttd is aimed to provide a solid, enterprise grade, extensible open-source MQTT broker for IoT(M2M) applications that need to support ten millions of concurrent MQTT clients.

  • Easy to install
  • Massively scalable
  • Easy to extend
  • Solid stable

Features

  • Full MQTT V3.1/V3.1.1 protocol specification support
  • QoS0, QoS1, QoS2 Publish and Subscribe
  • Session Management and Offline Messages
  • Retained Messages Support
  • Last Will Message Support
  • TCP/SSL Connection Support
  • MQTT Over Websocket(SSL) Support
  • HTTP Publish API Support
  • $SYS/borkers/# Support
  • Client Authentication with clientId, ipaddress
  • Client Authentication with username, password.
  • Client ACL control with ipaddress, clientid, username.
  • Cluster brokers on several servers.
  • Bridge brokers locally or remotelly
  • 500K+ concurrent clients connections per server
  • Extensible architecture with plugin support
  • Passed eclipse paho interoperability tests

Design

emqttd architecture

QuickStart

Download binary packeges for linux, mac and freebsd from http://emqtt.io/downloads.

For example:

tar xvf emqttd-ubuntu64-0.7.0-alpha.tgz && cd emqttd

# start console
./bin/emqttd console

# start as daemon
./bin/emqttd start

# check status
./bin/emqttd_ctl status

# stop
./bin/emqttd stop

Build from source:

git clone https://github.com/emqtt/emqttd.git

cd emqttd && make && make dist

GetStarted

Read emqtt wiki for detailed installation and configuration guide.

Benchmark

Benchmark 0.6.1-alpha on a ubuntu/14.04 server with 8 cores, 32G memory from QingCloud:

200K+ Connections, 200K+ Topics, 20K+ In/Out Messages/sec, 20Mbps+ In/Out with 8G Memory, 50%CPU/core

License

The MIT License (MIT)

Contributors

@hejin1026 @desoulter @turtleDeng @Hades32 @huangdan

Author

Feng Lee feng@emqtt.io