Paraffin IoT Platform

About

Paraffin is IoT platform based on node.js and mongodb with MQTT, HTTP and CoAP bridge.

Paraffin IoT Platform diagram

Paraffin will enable you to put your IoT 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 by Parse Server api server will be able to authorize your device list so broker perform authentication by your entry data in MongoDB by api server. Broker is based on Ponte and is under development so it should work. It need time to release stable version.

Features

Installation

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

Using Shell Script

asciicast

Run the following command in your terminal to install the latest official Paraffin IoT Platform release. For customization environment variables, make ./broker.env and ./apiserver.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/ParaffinIoT/paraffin/master/install.sh | bash

Using Git

Download Paraffin IoT Platform git

git clone https://github.com/ParaffinIoT/paraffin

cd paraffin

sudo docker-compose up

Tutorial

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

Development

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

Microservice Description
API Server API Server
Brokero Paraffin Installer Shell Script
Broker MQTT/HTTP/CoAP server/broker
Dashboard Paraffin Admin Dashboard

Development Environment Variable

During deployment, every microservice needs to be set to the following environment variables (remember to change them with your own microservices, mongodb). You can customize .env file in every repository.

Learn more

You can find a test version of Paraffin IoT Platform at paraffin.iokloud.com as soon as possible.

If you find Paraffin useful, consider supporting the project by buying a support package from me by writing an email to iokloud.com@gmail.com

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

Security Issues

Paraffin-IoT 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 iokloud.com@gmail.com

Feedback

Use the issue tracker for bugs. Tweet us for any idea that can improve the project.

Authors

Hadi Mahdavi Nana Kwame Zoe Kwarteng Wisdom Ahmad Rafiee