Mainflux is modern, scalable, secure, open-source, and patent-free IoT cloud platform written in Go.
It accepts user and thing (sensor, actuator, application) connections over various network protocols (i.e. HTTP, MQTT, WebSocket, CoAP), thus making a seamless bridge between them. It is used as the IoT middleware for building complex IoT solutions.
For more details, check out the official documentation.
The following are needed to run Mainflux:
Developing Mainflux will also require:
Once the prerequisites are installed, execute the following commands from the project's root:
docker-compose -f docker/docker-compose.yml up
This will bring up the Mainflux docker services and interconnect them. This command can also be executed using the project's included Makefile:
If you want to run services from specific release checkout code from github and make sure that
MF_RELEASE_TAG in .env is being set to match the release version
git checkout tags/<release_number> -b <release_number> # e.g. `git checkout tags/0.13.0 -b 0.13.0`
.env file contains:
docker-composeshould be used for development and testing deployments. For production we suggest using Kubernetes.
The quickest way to start using Mainflux is via the CLI. The latest version can be downloaded from the official releases page.
It can also be built and used from the project's root directory:
make cli ./build/mainflux-cli version
Additional details on using the CLI can be found in the CLI documentation.
If you spot an error or a need for corrections, please let us know - or even better: send us a PR.
Main architect and BDFL of Mainflux project is @drasko.
Additionally, @nmarcetic and @janko-isidorovic assured overall architecture and design, while @manuio and @darkodraskovic helped with crafting initial implementation and continuously worked on the project evolutions.
Maintainers are listed in MAINTAINERS file.
The Mainflux team would like to give special thanks to @mijicd for his monumental work on designing and implementing a highly improved and optimized version of the platform, and @malidukica for his effort on implementing the initial user interface.
There are many companies offering professional support for the Mainflux system.
If you need this kind of support, best is to reach out to @drasko directly, and he will point you out to the best-matching support team.
Thank you for your interest in Mainflux and the desire to contribute!
You like Mainflux and you would like to make it your day job? We're always looking for talented engineers interested in open-source, IoT and distributed systems. If you recognize yourself, reach out to @drasko - he will contact you back.
The best way to grab our attention is, of course, by sending PRs 😎.