Go to file
Jovan Kostovski 74f890128d fixed a typo
Signed-off-by: Jovan Kostovski <chombium@gmail.com>
2018-02-06 01:48:38 +01:00
.github Move contributing guide to .github folder 2017-12-29 10:49:03 +01:00
bin fixed a typo 2018-02-06 01:48:38 +01:00
cmd Add HTTP auth check (#128) 2018-01-07 14:42:38 +01:00
coap Remove comments, clean code 2017-10-07 19:13:20 +02:00
http Fix 403 errors handling 2018-01-26 20:50:31 +01:00
manager Fix 403 errors handling 2018-01-26 20:50:31 +01:00
vendor Add circuit breaker toward the manager service 2017-12-12 11:20:57 +01:00
writer Fix #116: remove base values from C* tables (#140) 2018-01-06 22:36:44 +01:00
.dockerignore Add HTTP auth check (#128) 2018-01-07 14:42:38 +01:00
Dockerfile.coap Add coap support 2017-10-01 16:38:32 +02:00
Dockerfile.http Integrate http adapter service 2017-09-23 01:57:14 +02:00
Dockerfile.manager Integrate manager service 2017-09-23 01:03:27 +02:00
Dockerfile.writer Integrate message writer service 2017-09-23 01:22:21 +02:00
LICENSE Switch LICENSE to Apache v2.0 2015-10-09 23:35:23 +02:00
MAINTAINERS Remove lora-related artifacts 2017-09-22 23:17:04 +02:00
Makefile Remove unused service references 2017-10-01 02:18:03 +02:00
README.md Add features 2017-10-07 18:44:12 +02:00
glide.lock Add circuit breaker toward the manager service 2017-12-12 11:20:57 +01:00
glide.yaml Add circuit breaker toward the manager service 2017-12-12 11:20:57 +01:00
version.go Update the API documentation of manager service 2017-12-29 10:22:37 +01:00

README.md

Mainflux

build go report card license chat

banner

Mainflux is modern, scalable, secure open source and patent-free IoT cloud platform written in Go.

It accepts user, device, and 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.

Features

  • Protocol bridging (i.e. HTTP, MQTT, WebSocket, CoAP)
  • Device management and provisioning
  • Linearly scalable data storage
  • Fine-grained access control
  • Platform logging and instrumentation support
  • Container-based deployment using Docker

Quickstart

Docker

To start the docker composition, execute the startup script from bin directory:

./mainflux-docker.sh start  

If the command successfully completes, you can verify that the all images are up & running by executing the following command in the terminal window:

docker ps

The composition can be terminated in the following way:

./mainflux-docker.sh stop

From sources

To download all the sources, and place them in appropriate locations (i.e. $GOPATH), use the installation script. Once it completes, the script will provide the instructions on how to finish the manual installation (i.e. install the required infrastructure).

Contributing

Thank you for your interest in Mainflux and wish to contribute!

  1. Take a look at our open issues.
  2. Checkout the contribution guide to learn more about our style and conventions.
  3. Make your changes compatible to our workflow.

Community