Skip to Content

Recognoil Cloud Stand-alone Edition

Why should we consider an Offline Standalone version?

Although TechTest company guarantees data security and privacy, we understand that some customers' policies do not allow to use the recommended Recognoil Cloud (online).

For this reason, an offline "stand-alone" version of the software installed locally in your PC is offered.

Online version ​

Requirements:

  • internet connection and browser on any PC
  • Recognoil device to be connected to the internet over a 2.4 GHz Wi-Fi network

Features:

  • Automatic updates with new features, code and stability improvements 

Offline Standalone version

Requirements:

  • dedicated PC (desktop, laptop) 
  • OS MS Windows or Ubuntu Linux installed
  • Wi-Fi access point for a PC and Recognoil 
  • Docker software for application containerization 

Features:

  • Only manual software update possible



Cloud Standalone - block diagram

The system consists of one wireless router, the Recognoil 3W device and a PC.

The system can be completely isolated from the Internet.

Please note that the IP address of "192.168.0.111" of the PC is mandatory.

Step-by-step guide - how to install Recognoil Cloud Standalone


Please note that you will need an internet connection to go through this set-up process completely.


Install WSL on Windows

  • Open PowerShell as Administrator
  • wsl --install
  • Setup the username and password for Ubuntu Linux

https://learn.microsoft.com/en-us/windows/wsl/install

Install Docker on WSL

  • Restart your PC 
  • Run the WSL environment using windows key and typing "Ubuntu"
  • Follow the steps using the link to the right

Install Docker on Ubuntu using the apt repository

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Install Docker Desktop on Windows

Docker Desktop for Windows -​​​​ x86_64

  • restart the PC after installation

https://docs.docker.com/desktop/setup/install/windows-install/

Enable "Expose daemon on tcp://localhost:2375 without TLS" in Docker Desktop Settings page.

Enable "Start Docker Desktop when you sign in to your computer"

  • restart the PC


Run Ubuntu in Windows (press Windows key and type "Ubuntu" and hit enter).

  • Create a directory "rcld" and change directory to rcld.
  • create also a folder named app under rcld.
mkdir rcld
cd rcld
mkdir app



Please contact our support and get your 

  • database initialization file (init.sql)
  • docker-compose.yml file
  • hub.docker.com password


Copy the

  • database initialization file (init.sql)
  • docker-compose.yml file

to Linux\Ubuntu\home\reco\rcld folder.


Open WSL Ubuntu and type

docker login
  • Now please follow the log-in instructions displayed in the Ubuntu window.
  • Use the following credentials to log-in:
username: techtestd1
password: **********

Please contact our support to get your password.

Pull the container image from TechTest's repository, for example

docker pull techtestd1/reco_cld_sa:0.92a3d

https://hub.docker.com/repository/docker/techtestd1/reco_cld_sa/general

Start the container

docker compose up

(or)

docker-compose up


Open a second "Ubuntu" window and

  • Install mysql core:


sudo apt install mysql-client-core-8.0
sudo apt install mariadb-client-core


  • Run the SQL initialization script
mysql --host=127.0.0.1 --port=32000 -u reco -p rcld < init.sql



Contact our support to get your database initialization file (init.sql)

Test the installation in your web browser using address:

http://192.168.0.111:5000

Please note that on a local machine, you do not need a secured (https) connection. Please use only "http://"

Notes

  • Please note that the Recognoil Server does not work when the PC falls into a sleep mode. Please adjust the PC Standby timeout appropriately.
  • Recognoil 3W and the PC must be using the same Wi-Fi network and the IP address range of 192.168.0.x/24
  • The PC must have an IP address of 192.168.0.111

More information about network router settings:

Setup your wireless router