Mainflux#

About#

Mainflux is modern, highly-secured open source and patent-free IoT cloud platform written in Go, based on a set of microservices.

It allows device, user and application connections over various network protocols, like HTTP, MQTT, WebSocket and CoAP, making a seamless bridge between them. It is used as the IoT middleware for building complex IoT solutions.

gophersBanner

More precisely, Mainflux is multi-protocol device-agnostic message relay with distributed time-series data storage and multi-user, multi-tenant device and application management middleware.

Even more precisely Mainflux is:

  • Device manager - accepts device connections on southbound interface
  • Application manager - accepts application connections on northbound interface
  • Messaging bridge - relays messages between devices and applications
  • Time-series storage engine - stores and queries measurements datapoints in the time-series format

We say that Mainflux is "multi-protocol" because it supports several networking protocols that proliferate in IoT world:

  • HTTP
  • WebSocket
  • MQTT
  • LwM2M (CoAP) - WIP

We say that Mainflux is "device-agnostic" because type of device that connects to it is completely transparent to Mainflux due it's generic internal device model (representation). That means that you can connect absolutely every device to Mainflux

Mainflux is built with <3 by Mainflux Company and community contributors.

Architecture#

Mainflux IoT cloud is composed of several components, i.e. microservices:

Link Description
mainflux-http-sender HTTP message API server
mainflux-manager Service for system provisioning
mainflux-influxdb-writer Wroker behind NATS that writes messages into DB
mainflux-influxdb-reader HTTP API server for reading messages from DB
mainflux-auth Authentication and Authorization Server
mainflux-mqtt MQTT PUB/SUB Broker (with WebSocket support)
mainflux-coap CoAP Server
mainflux-ui System Dashboard in Angular 2 Material
mainflux-cli Interactive command-line interface
MongoDB Devices/Measurements NoSQL Database
InfluxDB Time-Series Database for Messages
PostgreSQL DB needed for Auth service (Hydra and Ladon)
Hydra OAuth-2.0 Server
Redis System async events and caching
NATS System event bus
NGINX Reverse Proxy with Auth forwarding

arch

Docker composition that constitues Mainflux IoT infrastructure is defined in the docker-compose.yml.

Features#

An extensive (and incomplete) list of features includes:

  • Responsive and scalable architecture based on a set of microservices
  • Set of clean APIs: HTTP RESTful, MQTT, WebSocket and CoAP
  • SDK - set of client libraries for many HW platforms in several programming languages: C/C++, JavaScript, Go and Python
  • Device management and provisioning and OTA FW updates
  • Highly secured connections via TLS and DTLS
  • Enhanced and fine-grained security via deployment-ready Mainflux Authentication and Authorization Server with Access Control scheme based on customizable API keys and scoped JWT
  • Easy deployment and high system scalability via Docker images
  • Clear project roadmap, extensive development ecosystem and highly skilled developer community
  • And many more

Authors#

Main architect and BDFL of Mainflux project is @drasko. Additionaly, initial version of Mainflux was architectured and crafted by @janko-isidorovic, @nmarcetic and @mijicd.