2016-04-29 04:07:16 +08:00
|
|
|
# Mainflux
|
2015-10-02 22:15:46 +08:00
|
|
|
|
2017-09-23 08:27:49 +08:00
|
|
|
[![build][ci-badge]][ci-url]
|
|
|
|
|
[![go report card][grc-badge]][grc-url]
|
2018-04-09 04:57:56 +08:00
|
|
|
[![coverage][cov-badge]][cov-url]
|
2017-09-23 08:27:49 +08:00
|
|
|
[![license][license]](LICENSE)
|
|
|
|
|
[![chat][gitter-badge]][gitter]
|
2015-07-07 05:43:19 +08:00
|
|
|
|
2017-09-23 08:27:49 +08:00
|
|
|
![banner][banner]
|
2015-07-07 05:43:19 +08:00
|
|
|
|
2017-09-23 19:43:23 +08:00
|
|
|
Mainflux is modern, scalable, secure open source and patent-free IoT cloud platform written in Go.
|
2015-10-02 22:18:35 +08:00
|
|
|
|
2017-09-23 19:43:23 +08:00
|
|
|
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.
|
2016-11-13 02:49:23 +08:00
|
|
|
|
2017-09-23 08:27:49 +08:00
|
|
|
For more details, check out the [official documentation][docs].
|
2015-10-02 22:18:35 +08:00
|
|
|
|
2017-09-23 08:27:49 +08:00
|
|
|
## Features
|
2016-11-24 09:19:06 +08:00
|
|
|
|
2017-09-23 19:43:23 +08:00
|
|
|
- Protocol bridging (i.e. HTTP, MQTT, WebSocket, CoAP)
|
|
|
|
|
- Device management and provisioning
|
|
|
|
|
- Fine-grained access control
|
2017-10-02 02:40:19 +08:00
|
|
|
- Platform logging and instrumentation support
|
2017-09-23 19:43:23 +08:00
|
|
|
- Container-based deployment using [Docker][docker]
|
2017-01-15 07:57:59 +08:00
|
|
|
|
2017-09-23 08:27:49 +08:00
|
|
|
## Quickstart
|
2017-09-19 03:38:06 +08:00
|
|
|
|
2018-03-12 01:06:01 +08:00
|
|
|
Before proceeding, install the following prerequisites:
|
2017-09-19 03:38:06 +08:00
|
|
|
|
2018-03-12 01:06:01 +08:00
|
|
|
- [Docker](https://docs.docker.com/install/)
|
|
|
|
|
- [Docker compose](https://docs.docker.com/compose/install/)
|
2017-09-25 18:00:28 +08:00
|
|
|
|
2018-03-12 01:06:01 +08:00
|
|
|
Once everything is installed, execute the following commands from project root:
|
2016-04-29 04:07:16 +08:00
|
|
|
|
2018-03-12 01:06:01 +08:00
|
|
|
```bash
|
2018-04-18 22:49:10 +08:00
|
|
|
docker-compose -f docker/docker-compose.yml up -d
|
2017-09-25 18:00:28 +08:00
|
|
|
```
|
2017-09-19 03:38:06 +08:00
|
|
|
|
2017-09-23 19:43:23 +08:00
|
|
|
## Contributing
|
|
|
|
|
|
|
|
|
|
Thank you for your interest in Mainflux and wish to contribute!
|
|
|
|
|
|
|
|
|
|
1. Take a look at our [open issues](https://github.com/mainflux/mainflux/issues).
|
2018-01-27 07:50:37 +08:00
|
|
|
2. Checkout the [contribution guide](.github/CONTRIBUTING.md) to learn more about our style and conventions.
|
2017-09-23 19:43:23 +08:00
|
|
|
3. Make your changes compatible to our workflow.
|
|
|
|
|
|
2017-09-23 08:27:49 +08:00
|
|
|
## Community
|
|
|
|
|
|
|
|
|
|
- [Google group][forum]
|
|
|
|
|
- [Gitter][gitter]
|
|
|
|
|
- [Twitter][twitter]
|
|
|
|
|
|
2018-04-09 05:03:12 +08:00
|
|
|
[banner]: https://github.com/mainflux/mainflux/blob/master/docs/img/gopherBanner.jpg
|
2017-09-23 23:41:08 +08:00
|
|
|
[ci-badge]: https://semaphoreci.com/api/v1/mainflux/mainflux/branches/master/badge.svg
|
|
|
|
|
[ci-url]: https://semaphoreci.com/mainflux/mainflux
|
2017-09-23 08:27:49 +08:00
|
|
|
[docs]: http://mainflux.readthedocs.io
|
|
|
|
|
[docker]: https://www.docker.com
|
|
|
|
|
[forum]: https://groups.google.com/forum/#!forum/mainflux
|
|
|
|
|
[gitter]: https://gitter.im/mainflux/mainflux?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
|
|
|
|
|
[gitter-badge]: https://badges.gitter.im/Join%20Chat.svg
|
|
|
|
|
[grc-badge]: https://goreportcard.com/badge/github.com/mainflux/mainflux
|
|
|
|
|
[grc-url]: https://goreportcard.com/report/github.com/mainflux/mainflux
|
2018-04-09 04:57:56 +08:00
|
|
|
[cov-badge]: https://codecov.io/gh/mainflux/mainflux/branch/master/graph/badge.svg
|
|
|
|
|
[cov-url]: https://codecov.io/gh/mainflux/mainflux
|
2017-09-23 08:27:49 +08:00
|
|
|
[license]: https://img.shields.io/badge/license-Apache%20v2.0-blue.svg
|
|
|
|
|
[twitter]: https://twitter.com/mainflux
|
