install MikroWizard (manual)

Table of Contents

Install Nginx:
- Open the terminal and run the following commands:
- Verify Nginx installation:
Install Redis with Time Series:
- Verify Nginx installation:
Install PostgreSQL Database
- Open the terminal and run the following commands:
Create a new PostgreSQL user and database:
- Verify PostgreSQL installation:
Installing MikroFront:
Installing MikroMan:
Finish

To install and configure Nginx, Redis with Time Series, and PostgreSQL Database on Ubuntu, follow these step-by-step instructions:

Install Nginx: #

Open the terminal and run the following commands: #

Bash

sudo apt update
sudo apt install nginx
sudo systemctl reload nginx

MikroWizard Nginx installation

Verify Nginx installation: #

In your web browser, type in your server’s IP address. You should see the default Nginx landing page.

Install Redis with Time Series: #

The Time series module comes either as a separate module or as part of the Redis Stack solution. If you don’t want to install Redis Stack (which is the best option), you can install the TimeSeries module separately:

To install Redis Stack :
Please follow this link from Redis official website:
- https://redis.io/docs/latest/operate/oss_and_stack/install/install-stack/linux/
Install Redis and add a time series module:
- First, install redis-server

Bash

sudo apt install redis-server

MikroWizard Redis installation

Follow the instructions on Redis official website
- https://onelinerhub.com/redis-timeseries/how-to-install-redis-time-series

Verify Nginx installation: #

Bash

redis-cli INFO

MikroWizard Redis installation

Install PostgreSQL Database #

Open the terminal and run the following commands: #

Bash

sudo apt install postgresql

MikroWizard PostgreSQL installation

Create a new PostgreSQL user and database: #

Bash

sudo -i -u postgres

psql
CREATE USER your_username WITH PASSWORD 'your_password';
CREATE DATABASE your_database_name OWNER your_username;
\q
exit

MikroWizard PostgreSQL installation

Verify PostgreSQL installation: #

Access PostgreSQL command line interface

Bash

psql -U your_username -d your_database_name

MikroWizard PostgreSQL installation

Installing MikroFront: #

download and extract the latest front build

Bash

wget https://github.com/MikroWizard/mikrofront/releases/download/1.0.0-beta/mikrofront-1.0.0-beta.tar.gz
tar -xpzf mikrofront-1.0.0-beta.tar.gz -C /usr/share/nginx/html/

MikroWizard MikroFront installation

Navigate to the Nginx configuration directory and edit the configuration file:

Bash

cd /etc/nginx/sites-available/
sudo nano /etc/nginx/sites-enabled/default

MikroWizard MikroFront installation

Replace config with the following config

Bash

server {
  listen 80;
  sendfile on;
  default_type application/octet-stream;

  gzip on;
  gzip_http_version 1.1;
  gzip_disable      "MSIE [1-6]\.";
  gzip_min_length   256;
  gzip_vary         on;
  gzip_proxied      expired no-cache no-store private auth;
  gzip_types        text/plain text/css application/json application/javascript application/x-javascript text/xml application/xml application/xml+rss text/javascript;
  gzip_comp_level   9;

  root /usr/share/nginx/html;

  location / {
    try_files $uri $uri/ /index.html =404;
  }
  location /api {
    proxy_pass http://host.docker.internal:8181;

    proxy_set_header    Host                $http_host;
    proxy_set_header    X-Real-IP           $realip_remote_addr;
    proxy_set_header    X-Forwarded-Proto   $scheme;
    proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;

    proxy_http_version 1.1;
    proxy_set_header Connection "";
  }
  location /api/frontver {
    add_header Cache-Control 'no-store';
    add_header Cache-Control 'no-cache';
    expires 0;
    index version.json;
    alias /usr/share/nginx/html;
  }
}

MikroWizard MikroFront installation