atmantech/atman-iot repository overview

⁠Introduction

We strongly believe that our world can be a better place, if we make our decisions based on data. Our mission is to empower you to make better decisions by creating all the necessary tools for collecting, analyzing and visualizing the key data for your organization.

With that in mind, we have created Atman IoT⁠, an out of the box back end, in the form of a docker server image, for your Internet of Things application, currently in public beta.

The following paragraphs will help you install and start the server, as well as provide you with basic usage scenarios.

⁠Supported tags

• Kon.Ky⁠
• Fo.tsi⁠
• beta
• latest (points to Kon.Ky⁠ )

⁠Quick reference

• Web page:
  Find out more in the product web page⁠

• API Documentation
  Detailed API end point documentation is available here⁠

• Live API
  You can try our live API demo⁠ and see if our product fits your needs, before having to install it

⁠Installation

Atman IoT can be installed via docker-compose⁠ by following the next five (5) steps:

1. Create a new directory and change to it:

$ mkdir /home/$USER/atman-iot && cd /home/$USER/atman-iot 

1. Create a file named docker-compose.yml and edit it with your favorite editor:

$ nano docker-compose.yml 

1. Copy the following into the above file and save it (Please make sure you change "MYSQL_ROOT_PASSWORD" of docker-compose.yml before the next step. Please leave "MYSQL_PASSWORD" for now.):

version: '3.1' 

services:
  atman-iot:
    image: atmantech/atman-iot
    volumes:
       - ./UPLOADS:/UPLOADS:consistent
       - ./config:/config:consistent
    ports:
      - "2121:2121"
      - "1024-1048:1024-1048"
      - "3000:3000"
    depends_on:
      - atmandb
    links:
      - atmandb
  atmandb:
    image: mysql:5.7.27
    command: --default-authentication-plugin=mysql_native_password --character-set-server=utf8 --collation-server=utf8_general_ci
    environment:
      MYSQL_ROOT_PASSWORD: password
      MYSQL_DATABASE: atman_iot
      MYSQL_USER: atman-iot
      MYSQL_PASSWORD: password 
    ports:
      - 33060:3306
  adminer:
    image: adminer
    ports:
      - 8080:8080
    depends_on:
      - atmandb

1. Install with docker-compose:

$ docker-compose up 

1. Chance mysql user password (optional)

• Open the database admin page (see next paragraph) and login as root, with the "MYSQL_ROOT_PASSWORD" you used in your docker-compose.yml
• Select the "atman_iot" database, then click on the " Privileges" tab, then edit the privileges of user "atman-iot".
• Edit your local configuration file and change the database password:

$ nano /home/$USER/code/atman-iot/config/mysql.datasource.json 

⁠Accessing the server interfaces

• Local API documentation: http://localhost:3000/api/documentation.html⁠

• API Explorer: http://localhost:3000/api/explorer⁠

• Database admin page: http://localhost:8080/?server=atmandb⁠

⁠Lisence