borokero/borokero.github.io

☀️ Borokero Platform Website

Borokero ;) Open Source Microservice Platform

About

Open Source Back End for IoT, Web, Apps and Mobile

Borokero will enable you to put your IoT, Mobile, Apps or Web API services on your own server simply and painless in one command. It supports the popular MQTT protocol in sync with HTTP. It is in javascript and authenticate and authorize your device list so broker perform authentication by your entry data in oauth server like Keycloak. Borokero is an open-source solution that includes a scalable server and a multiprotocol API. Borokero is opensource forever under development so it should work. It need time to release stable version.

Features

• Simple and Scalable based on docker-compose and as soon as possible on kubernetes
• HTTP, MQTT connections together as a bridge.
• MQTT 3.1 and 3.1.1 compliant.
• Sercured with authentication and authorization.

Installation

Borokero IoT Platform is installed by two methods. Firstly besure docker and docker-compose is installed.

Using Shell Script

Run the following command in your terminal to install the latest official Borokero IoT Platform release. For customization environment variables, make iot-mqtt.env and iot-http.env with your desired variables before run installer shell script. Deafualt value will loaded if .env files is not existence in current path.

sudo curl -o- https://raw.githubusercontent.com/borokero/borokero/master/install.sh | bash

Using Git

Download Borokero Platform git

git clone https://github.com/borokero/borokero-docker-compose

cd borokero-docker-compose

sudo docker-compose up

Tutorial

You can find a step by step tutorial in wiki page .

Development

Borokero is composed by different microservices. Follow the installation guidelines for each of them.

Microservice	Description
Docs	Borokero Documentations
Borokero	Borokero Installer Shell Script
HTTP Bridge	HTTP/HTTPS server
MQTT Bridge	MQTT/MQTTS broker
Borokero Auth	Borokero Authentication and Authorization
Docker-Compose	Docker-Compose confiuration
CLI	Borokero CLI
Borokero Webpage	Borokero Github Page

Development Environment Variable

During deployment, every microservice needs to be set to the following environment variables. You can customize .env file in every repository.

Learn more

You can find a test version of Borokero IoT Platform at borokero.iokloud.com as soon as possible. If you find Borokero useful, consider supporting the project by buying a support package from me by writing an email to [email protected]

Check out our showcase wiki page! Feel free to add yourself! :)

Security Issues

Borokero sits between your system and the devices: this is a tough role, and we did our best to secure your systems. However, you might find a security issue: in that case, email [email protected]

Feedback

Use the issue tracker for bugs. Tweet us for any idea that can improve the project. Any questions? Technical question? Please ask the community Borokero Discord Community

Contribution

At Borokero we are strong believers in community, transparency, technical excellence & innovation. That is why we made Borokero Open-Source and actively contribute to, and depend on, this ecosystem.

Links

• Aedes
• Mosca
• Ponte
• Parse Server
• Mongodb
• MQTT protocol
• MQTT.js
• Paraffin Platform

Authors

• Hadi Mahdavi
• Nana Kwame Zoe
• Kwarteng Wisdom
• Ahmad Rafiee