yuanbiao/emqx - emqx

Go to file

Feng Lee 76ba3cd149 0.10.4		2015-09-18 11:46:34 +08:00
deps	0.2 project structure	2014-12-06 19:12:29 +08:00
doc	global unique id	2015-07-05 20:15:53 +08:00
ebin	ebin	2015-08-09 09:53:56 +08:00
include	Add headers to mqtt_client	2015-08-13 13:01:06 +05:30
plugins	rm sockjs	2015-09-18 10:05:51 +08:00
rel	pubsub pool_size 8	2015-09-16 22:19:42 +08:00
src	Merge pull request #301 from emqtt/dev-feng	2015-09-18 10:42:30 +08:00
test	add more match tests	2015-08-16 22:01:41 +08:00
.gitignore	ebin/.placeholder	2015-08-09 09:52:21 +08:00
.gitmodules	rm sockjs	2015-09-18 10:07:58 +08:00
.travis.yml	add	2015-02-12 21:59:43 +08:00
CHANGELOG.md	0.10.4	2015-09-18 11:46:34 +08:00
LICENSE	gen_server2	2015-08-15 20:42:46 +08:00
Makefile	plugins	2015-08-09 17:30:31 +08:00
PLUGIN.md	submodule	2015-08-09 12:06:30 +08:00
README.md	0.10.0	2015-08-20 00:40:00 +08:00
rebar	upgrade esockd, mochiweb	2015-03-02 01:40:22 +08:00
rebar.config	lib_dirs	2015-08-07 16:34:28 +08:00

README.md

Overview

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 and Mobile 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/brokers/# 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

Modules

emqttd_auth_clientid - Authentication with ClientIds
emqttd_auth_username - Authentication with Username and Password
emqttd_auth_ldap - Authentication with LDAP
emqttd_mod_presence - Publish presence message to $SYS topics when client connected or disconnected
emqttd_mod_autosub - Subscribe topics when client connected
emqttd_mod_rewrite - Topics rewrite like HTTP rewrite module

Plugins

emqttd_plugin_template - Plugin template and demo
emqttd_dashboard - Web Dashboard
emqttd_plugin_mysql - Authentication with MySQL
emqttd_plugin_pgsql - Authentication with PostgreSQL
emqttd_plugin_kafka - Publish MQTT Messages to Kafka
emqttd_plugin_redis - Redis Plugin

Dashboard

The broker released a simple web dashboard in 0.10.0 version.

Address: http://host:18083

Design

QuickStart

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

For example:

unzip emqttd-ubuntu64-0.10.0-beta-20150820.zip && 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