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 R17+ to build.

Demo Server: tcp://t.emqtt.io:1883

Follow us on Twitter: @emqtt

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
• 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
• 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_auth_ldap	Authentication with LDAP
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_plugin_mysql	MySQL Authentication/ACL Plugin
emqttd_plugin_pgsql	PostgreSQL Authentication/ACL Plugin
emqttd_plugin_redis	Redis Authentication/ACL Plugin
emqttd_plugin_mongo	MongoDB Authentication/ACL Plugin
emqttd_stomp	Stomp Protocol Plugin
emqttd_sockjs	SockJS(Stomp) Plugin
emqttd_recon	Recon 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-macosx-0.16.0-beta-20160216.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.git

cd emqttd && make && make dist

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

• @callbay
• @lsxredrain
• @hejin1026
• @desoulter
• @turtleDeng
• @Hades32
• @huangdan
• @phanimahesh
• @dvliman

Author

Feng Lee feng@emqtt.io

License

Apache License Version 2.0