Build Status Codacy Badge Codacy Badge

Lannister is a lightweight MQTT broker equipped with full specifications support, Clustering, WebSocket, SSL written in Java.

MQTT is a machine-to-machine (M2M)/"Internet of Things" connectivity protocol. It was designed as an extremely lightweight publish/subscribe messaging transport. It is useful for connections with remote locations where a small code footprint is required and/or network bandwidth is at a premium. For example, it has been used in sensors communicating to a broker via satellite link, over occasional dial-up connections with healthcare providers, and in a range of home automation and small device scenarios. It is also ideal for mobile applications because of its small size, low power usage, minimised data packets, and efficient distribution of information to one or many receivers -


Getting Started

Starting from package

  1. Go to
  2. Download a compressed file preferred (zip / tar.gz / tar.bz2)
  3. Unpack downloaded file and move into the directory
  4. Execute ./bin/
  5. For shutdown, execute ./bin/

Starting from source

# Download lannister source
git clone

# Change directory to lannister
cd lannister

# Build(The command builds all sub-projects(interface, server, plugin-example simultaneously)
mvn install

# Run lannister server
mvn exec:java -pl server

Project site

For deeper understanding of Lannister, please visit The site has complete information of Lannister includes all of the above links and development/production information.


Park Hyunjeong / [email protected]


Lannister is released under version 2.0 of the Apache License.