create emqx project

Feng Lee 0a7aa5857b add plugins/emqttd_plugin_template 10 tahun lalu
deps 3a6ed9a876 0.2 project structure 11 tahun lalu
doc 4ff7f9b2fe global unique id 10 tahun lalu
ebin b078565e1c ebin 10 tahun lalu
include 506dc0bd06 Add headers to mqtt_client 10 tahun lalu
plugins 0a7aa5857b add plugins/emqttd_plugin_template 10 tahun lalu
rel e8dbe3b378 clients, sessions 10 tahun lalu
src 0ef84d8017 Merge pull request #243 from emqtt/dev-hd 10 tahun lalu
test 30875c0706 fix test cases 10 tahun lalu
.gitignore 46732bcd72 ebin/.placeholder 10 tahun lalu
.gitmodules 0a7aa5857b add plugins/emqttd_plugin_template 10 tahun lalu
.travis.yml db6d9cc49b add 11 tahun lalu
CHANGELOG.md 48bced8599 0.10.0 10 tahun lalu
LICENSE f33cf11cd5 emqtt.io 10 tahun lalu
Makefile a9eb3c83ce plugins 10 tahun lalu
PLUGIN.md 30f6567c39 submodule 10 tahun lalu
README.md 8753e25ab9 contributors 10 tahun lalu
rebar 2d2aa2f79a upgrade esockd, mochiweb 11 tahun lalu
rebar.config 207c50bf14 lib_dirs 10 tahun lalu

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 Hooks, Modules and Plugins
  • Passed eclipse paho interoperability tests

Plugins

  • emqttd_auth_clientid - Authentication with ClientIds
  • emqttd_auth_mysql - Authentication with MySQL
  • emqttd_auth_ldap - Authentication with LDAP
  • emqttd_mod_autosub - Subscribe some topics automatically when client connected
  • emqttd_mod_presence - Publish presence message to $SYS topics when client connected or disconnected
  • emqttd_mod_rewrite - Topics rewrite like HTTP rewrite module

Design

emqttd architecture

QuickStart

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

For example:

tar xvf emqttd-ubuntu64-0.9.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

Author

Feng Lee feng@emqtt.io