Skip to content
This open source mIoT microservice created by the mimik team is an example IoT (Internet of Thing) solution for developers to share data payloads and notifications across sensors and devices.
JavaScript Shell Dockerfile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


This open source mIoT microservice created by the mimik team is an example IoT (Internet of Thing) solution for developers to share sensor payloads and notifications across sensors and devices. More specifically, this edgeSDK microservice has the following functionality:

  1. Uploading sensor's data payload to other sensors or devices on the network.

  2. A new notification will be pushed to other devices after the payload is received.

Releases & Deployment

For latest update:

How to obtain the built-version of this microservice?

Please visit the releases section of this GitHub page to download the ready-to-deploy container image file of this microservice.

How to deploy this microservice on edgeSDK?

  1. Please make sure that you have downloaded the latest edgeSDK and it is running correctly on your targeted development platform.

  2. Please check that you have performed all the following prerequisite steps to setup you edgeSDK on your targeted platform:

    1. Register yourself on mimik's developer portal and add your application information to the portal to get authorization of edgeSDK access. Note: For information about Redirect URL, please go to link.

      Attention: Please safe keep your App-ID and Redirect URL for OAuth authorization later on.

    2. Get your edgeSDK access token from following OAuth tool of your targeted platform:

      Please read this on how to use the OAuth tool: Instruction on How to use the OAuth tool.

      OAuthtool application for Windows
      OAuthtool application for MacOs
      OAuthtool application for Linux

      Attention: Please safe keep your edgeSDK access token for later deployment use.

    3. If you have not downloaded the latest built version of the microservice at here, please download it now.
  1. Now you are ready to deploy this microservice on the edgeSDK, please run the following command on the bash terminal:
    Note: For Windows user, please download Cygwin or Git Bash to perform this.

    Attention: Please run the following commend under the same directory of your downloaded microservice file.

    The following curl command is for deploying this microservice to the edgeSDK:

    curl -i -H 'Authorization: Bearer **Replace withYourToken**' -F "image=@iot-v1.tar" http://localhost:8083/mcm/v1/images

    The following curl command is for specifying the environment variable:

    Note: You can always specify your own PUB_TOPIC and PUB_URI below to handle notifications and categorize the data payload.

    curl -i -H 'Authorization: Bearer **ReplacewithYourToken**' -d '{"name": "iot-v1", "image": "iot-v1", "env": {"MCM.BASE_API_PATH": "/iot/v1", "MATCH": "iot-v1", "uMDS": "", "PUB_URI": "iot/v1/notification", "PUB_TOPIC": "Data"} }' http://localhost:8083/mcm/v1/containers

  2. The output of the above command will return status code of 200 after the deployment is successful.

  3. Now you can read about the APIs in this microservice and check their functionalities on SwaggerHub.

How to build a microservice

Tools that you need:

Steps to build:

  1. Clone the microservice project from GitHub somewhere accessible on your home directory. This guide will start from the Downloads folder

    cd ~/Downloads

    git clone

  2. Navigate to the directory of the cloned repository.

  3. Install dependencies:

    npm install

  4. Next run build script:

    npm run-script build

  5. Verify that index.js is copied under /build directory.

    Attention: You will need to have the root permission to perform the following task.

  6. Change owner group of the build script in the deploy directory

    sudo chmod a+x deploy/

  7. Run build script to create an image for the container under deploy directory:

    cd deploy/ && ./

  8. Verify that a tar file of mimik container image is created as iot-v1.tar under deploy directory

  9. Now you can redirect back to the deployment section and deploy your newly built microservice.

Source Code Navigation

This Repository Folders

- src/     the main source code for the microservice
- build/   the compiled javascript (after running build scripts)
- deploy/  image file for the container

For more details about the src/ directory, please visit the README file under the src/ directory.

You can’t perform that action at this time.