Git Product home page Git Product logo

LF Edge NanoMQ

GitHub Release Build Status Docker Pulls Discord Twitter YouTube Community codecov License

NanoMQ MQTT Broker (NanoMQ) is an all-around Edge Messaging Platform that includes a blazing-fast MQTT Broker for the IoT/IIoT and a lightweight Messaging Bus for SDV.

NanoMQ's embedded Actor architecture extends NNG's internal asynchronous I/O, plus an enhanced message passing and scheduling system to maximize the overall capacity. Fine-tuned towards the embedded environment and mission-critical scenarios.

NanoMQ fully supports MQTT V3.1.1/3.1 and MQTT V5.0.

For more information, please visit NanoMQ homepage.

Features

  • Cost-effective on an embedded platform;
  • Fully based on native POSIX. High Compatibility;
  • Pure C implementation. High portability;
  • Fully asynchronous I/O and multi-threading;
  • Good support for SMP;
  • Low latency & High handling capacity;

image

Get Started

Run NanoMQ using Docker

docker run -d --name nanomq -p 1883:1883 -p 8083:8083 -p 8883:8883 emqx/nanomq:latest

More installation options

If you prefer to install and manage NanoMQ yourself, you can download the latest version from nanomq.io/downloads.

Run NanoMQ:

nanomq start
## or run nanomq with a specified configuration file
nanomq start --conf <config_file>

Build From Source

NanoMQ is dedicated to delivering a simple but powerful Messaging Hub on various edge platforms.

With this being said, NanoMQ can run on different architectures such like x86_64 and ARM with minor migration efforts.

Building NanoMQ requires a C99-compatible compiler and CMake (version 3.13 or newer).

  • It is recommended to compile with Ninja:

    git clone https://github.com/emqx/nanomq.git
    cd nanomq
    git submodule update --init --recursive
    mkdir build && cd build
    cmake -G Ninja ..
    ninja
  • Or compile with make:

    git clone https://github.com/emqx/nanomq.git 
    cd nanomq
    git submodule update --init --recursive
    mkdir build && cd build
    cmake .. 
    make

Build option

There are some configuration options specified using CMake defines in addition to the standard options like CMAKE_BUILD_TYPE:

  • -DNNG_ENABLE_QUIC=ON: to build NanoMQ with QUIC bridging feature
  • -DNNG_ENABLE_TLS=ON: to build with TLS support. (Need to install mbedTLS in advance)
  • -DBUILD_CLIENT=OFF: to disable nanomq tools client suite (including pub / sub / conn )
  • -DBUILD_ZMQ_GATEWAY=ON: to build nanomq_cli with zeromq gateway tool
  • -DBUILD_NFTP=ON: to build nanomq_cli with nftp client
  • -DBUILD_DDS_PROXY=ON: to build nanomq_cli with dds client ( proxy / sub / pub )
  • -DBUILD_BENCH=ON: to build nanomq_cli mqtt bench
  • -DENABLE_JWT=ON: to build JWT dependency for http server
  • -DNNG_ENABLE_SQLITE=ON: to build nanomq with sqlite support
  • -DBUILD_STATIC_LIB=ON: to build nanomq as a static library
  • -DBUILD_SHARED_LIBS=ON: to build nanomq as a shared library
  • -DDEBUG=ON: to enable debug flag
  • -DASAN=ON: to enable sanitizer
  • -DDEBUG_TRACE=ON: to enable ptrace (ptrace is a mechanism that allows one process to β€œtrace” the execution of another process. The tracer is able to pause execution, and inspect and modify memory and registers in the tracee process)

Resources

Get Involved

Our Website

Visit our official website to have a good grasp on NanoMQ MQTT broker and see how it can be applied in current industries.

Test Report

This test report shows how extraordinary and competitive the NanoMQ is in Edge Computing.

Currently the benchmark is for 0.2.5, the updated one with ver 0.3.5 is coming soon

Questions

The Github Discussions provides a place for you to ask questions and share your ideas with users around the world.

Slack

You could join us on Slack. We now share a workspace with the entire EMQ X team. After joining, find your channel!

  • #nanomq: is a channel for general usage, where for asking questions or sharing using experience;
  • #nanomq-dev: is a channel for MQTT lovers and developers, your great thoughts are what we love to hear;
  • #nanomq-nng: is a channel for guys who are interested in NNG, one of our fabulous dependencies.

Community

Some quotes from NNG's maintainer --- Garrett: I’m very excited about the synergy between the NanoMQ and NNG projects, and grateful for sponsorship that NNG has received from the NanoMQ team. The NanoMQ team has been able to push NNG's envelope, and the collaboration has already yielded substantial improvements for both projects. Further, the cooperation between these two project will make MQTT and SP (nanomsg) protocols easy to use within a single project as well as other capabilities (such as websockets, HTTPS clients and servers), greatly expanding the toolset within easy reach of the IoT developer. Further this comes without the usual licensing or portability/embeddability challenges that face other projects. Additional planned collaborative work will further expand on these capabilities to the benefit of our shared communities.

Open Source

NanoMQ is fully open-sourced!

License

MIT License

Authors

The EMQ Edge Computing team.

NanoMQ Edge Computing's Projects

arrow icon arrow

Apache Arrow is a multi-language toolbox for accelerated data interchange and in-memory processing

ekuiper icon ekuiper

A lightweight IoT edge analytics software

lwip icon lwip

A fork of https://git.savannah.nongnu.org/git/lwip.git

mp-quic icon mp-quic

Please read https://multipath-quic.org/2017/12/09/artifacts-available.html to figure out how to setup the code.

msquic icon msquic

Cross-platform, C implementation of the IETF QUIC protocol, exposed to C, C++, C# and Rust.

nanomq icon nanomq

An ultra-lightweight and blazing-fast Messaging broker/bus for IoT edge & SDV

nanosdk icon nanosdk

NanoSDK - MQTT 5.0-compliant SDK with QUIC support in NNG flavor

neuron icon neuron

Open Source Industrial IoT Gateway Software

ngtcp2 icon ngtcp2

ngtcp2 project is an effort to implement IETF QUIC protocol

nng icon nng

nanomsg-next-generation -- light-weight brokerless messaging -- MQTT 3.1.1 Supported

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.