5899177f57 | ||
---|---|---|
.github | ||
bin | ||
cmd | ||
coap | ||
http | ||
manager | ||
vendor | ||
writer | ||
.dockerignore | ||
CONTRIBUTING.md | ||
Dockerfile.coap | ||
Dockerfile.http | ||
Dockerfile.manager | ||
Dockerfile.writer | ||
LICENSE | ||
MAINTAINERS | ||
Makefile | ||
README.md | ||
glide.lock | ||
glide.yaml | ||
version.go |
README.md
Mainflux
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!
- Take a look at our open issues.
- Checkout the contribution guide to learn more about our style and conventions.
- Make your changes compatible to our workflow.