coap distributed-systems edge edge-computing golang iiot internet-of-things iot iot-cloud iot-gateway iot-platform lora lorawan lwm2m message-broker messaging mqtt opc-ua telecom web-socket

Go to file

Drasko DRASKOVIC ef00dac107 Correct Docker stuff This commit corrects docker-compose. Signed-off-by: Drasko DRASKOVIC <drasko.draskovic@gmail.com>		2015-12-07 00:27:52 +01:00
app	Correct Docker stuff	2015-12-07 00:27:52 +01:00
config	Correct Docker stuff	2015-12-07 00:27:52 +01:00
test	Add server.close() in apiTest.js	2015-11-02 01:49:39 +01:00
utils	Add `utils` dir and generateToken.js utility	2015-12-06 14:57:40 +01:00
.dockerignore	Added Docker file	2015-07-26 23:39:09 +02:00
.gitignore	Added Visual Studio files to .gitignore	2015-10-03 01:56:02 +02:00
.travis.yml	Add mongodb in Travis build	2015-11-02 01:49:39 +01:00
CONTRIBUTING.md	Switch LICENSE to Apache v2.0	2015-10-09 23:35:23 +02:00
Dockerfile	Correct Docker stuff	2015-12-07 00:27:52 +01:00
LICENSE	Switch LICENSE to Apache v2.0	2015-10-09 23:35:23 +02:00
MAINTAINERS	LICENSE, CONTRIBUTING and MAINTAINERS files	2015-10-04 05:10:45 +02:00
README.md	Cosmetics	2015-12-06 19:42:27 +01:00
docker-compose.yml	Correct Docker stuff	2015-12-07 00:27:52 +01:00
gulpfile.js	Add gulp-exit - gulp exits after finished tests	2015-11-02 01:49:39 +01:00
package.json	Add `bunyan` logger	2015-12-05 19:02:49 +01:00
server.js	Create logger as a separate file	2015-12-06 14:57:40 +01:00
swagger.yaml	Update swagger.yaml	2015-12-05 01:23:59 +01:00

README.md

Mainflux

About

Mainflux is lean open source industrial IoT cloud written in NodeJS.

It allows device, user and application connections over various network protocols, like HTTP, MQTT, WebSocket and CoAP, making a seamless bridge between them. As a consequence, Mainflux represents highly secure and highly optimised M2M platform based on the cutting-edge standards and approaches in the industry.

Architecture

Features

An extensive (and incomplete) list of featureas includes:

Set of clean APIs, Swagger documented: HTTP RESTful, MQTT, WebSocket and CoAP
Set of client libraries for many HW platforms in several programming languages: C/C++, JavaScript and Python
Device management and provisioning and OTA FW updates
UNIX-like permissions for device sharing
Highly secured connections via TLS and DTLS
User authentication via JSON Web Tokens
Responsive and scalable ModgoDB database
Modern architecture based on micro-services
LwM2M standard compliance via Coreflux
Partial oneM2M compliance
Easy deployment and high system scalability via Docker images
Clear project roadmap, extensive development ecosystem and highly skilled developer community
Professional support via Mainflux company
And many more

Install

Clone the repo:

git clone https://github.com/Mainflux/mainflux.git
cd mainflux

Install Node modules:

npm install

Run Gulp Task:

gulp

N.B. Mainflux has a MongoDB dependency. Database path and port can be defined in the config files.

Docker

Apart from main nodejs Docker image, Mainflux also uses mongo Docker image (database instance is run in a separte generic Docker image).

This is why Mainflux uses Docker Compose, to run both nodejs and mongo images at the same time and make a connection between them:

docker-compose up

Documentation

Development documentation can be found on our Mainflux GitHub Wiki

Community

Mailing lists

mainflux-dev - developers related. This is discussion about development of Mainflux IoT cloud itself.
mainflux-user - general discussion and support. If you do not participate in development of Mainflux cloud infrastructure, this is probably what you're looking for.