emqttd: An Erlang repository from farhadi

Overview

emqttd is a massively scalable and clusterable MQTT V3.1/V3.1.1 broker written in Erlang/OTP.

emqttd is fully open source and licensed under the Apache Version 2.0. emqttd implements both MQTT V3.1 and V3.1.1 protocol specifications, and supports WebSocket, STOMP, SockJS, CoAP and MQTT-SN at the same time.

emqttd requires Erlang R18+ to build since 1.1 release.

Cluster

The q.emqtt.com hosts a public emqttd cluster on QingCloud:

Goals

The emqttd project is aimed to implement a scalable, distributed, extensible open-source MQTT broker for IoT, M2M and Mobile applications that hope to handle 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 Message
Last Will Message
TCP/SSL Connection
MQTT Over WebSocket(SSL)
HTTP Publish API
MQTT-SN Protocol
STOMP protocol
STOMP over SockJS
$SYS/# Topics
ClientID Authentication
IpAddress Authentication
Username and Password Authentication
Access control based on IpAddress, ClientID, Username
Authentication with LDAP, Redis, MySQL, PostgreSQL and HTTP API
Cluster brokers on several servers
Bridge brokers locally or remotely
mosquitto, RSMB bridge
Extensible architecture with Hooks, Modules and Plugins
Passed eclipse paho interoperability tests

Modules

Module	Description
emqttd_auth_clientid	Authentication with ClientIds
emqttd_auth_username	Authentication with Username and Password
emqttd_mod_presence	Publish presence message when client connected or disconnected
emqttd_mod_subscription	Subscribe topics when client connected
emqttd_mod_rewrite	Topic path rewrite like HTTP rewrite module

Plugins

Plugin	Description
emqttd_plugin_template	Plugin template and demo
emqttd_dashboard	Web Dashboard
emqttd_auth_mysql	MySQL Authentication/ACL Plugin
emqttd_auth_pgsql	PostgreSQL Authentication/ACL Plugin
emqttd_auth_redis	Redis Authentication/ACL Plugin
emqttd_auth_mongo	MongoDB Authentication/ACL Plugin
emqttd_auth_http	Authentication/ACL by HTTP API
emqttd_auth_ldap	LDAP Authentication Plugin
emqttd_sn	MQTT-SN Protocol Plugin
emqttd_stomp	Stomp Protocol Plugin
emqttd_sockjs	SockJS(Stomp) Plugin
emqttd_recon	Recon Plugin
emqttd_reloader	Reloader Plugin

Dashboard

A Web Dashboard will be loaded when the emqttd broker started successfully.

The Dashboard helps monitor broker's running status, statistics and metrics of MQTT packets.

Default Address: http://localhost:18083

Default Login/Password: admin/public

Design

QuickStart

Download binary package for Linux, Mac and Freebsd from http://emqtt.io/downloads.

Installing on Ubuntu64, for example:

unzip emqttd-ubuntu64-2.0-beta1-20160830.zip && cd emqttd

# start console
./bin/emqttd console

# start as daemon
./bin/emqttd start

# check status
./bin/emqttd_ctl status

# stop
./bin/emqttd stop

Installing from source:

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

cd emqttd-relx && make

cd _rel/emqttd && ./bin/emqttd console

Documents

Read Documents on emqttd-docs.rtfd.org for installation and configuration guide.

Benchmark

Latest release of emqttd broker is scaling to 1.3 million MQTT connections on a 12 Core, 32G CentOS server.

Benchmark 0.12.0-beta on a CentOS6 server with 8 Core, 32G memory from QingCloud:

250K Connections, 250K Topics, 250K Subscriptions, 4K Qos1 Messages/Sec In, 20K Qos1 Messages/Sec Out, 8M+(bps) In, 40M+(bps) Out Traffic

Consumed about 3.6G memory and 400+% CPU.

Benchmark Report: benchmark for 0.12.0 release

Supports

Twitter: @emqtt
Homepage: http://emqtt.io
Downloads: http://emqtt.io/downloads
Wiki: https://github.com/emqtt/emqttd/wiki
Forum: https://groups.google.com/d/forum/emqtt
Mailing List: emqtt@googlegroups.com
Issues: https://github.com/emqtt/emqttd/issues
QQ Group: 12222225

Contributors

Partners

QingCloud is the world’s first IaaS provider that can deliver any number of IT resources in seconds and adopts a second-based billing system. QingCloud is committed to providing a reliable, secure, on-demand and real-time IT resource platform with excellent performance, which includes all components of a complete IT infrastructure system: computing, storage, networking and security.

Author

Feng Lee feng@emqtt.io

License

Apache License Version 2.0

farhadi/emqttd