DPO Radio

Measure Value, Not Just Traffic Explore new features in AesirX Analytics

Install Guide by Docker

Prerequisites

Before installing AesirX BI, you must have the following installed on your development computer:

You also must have installed 1st party server for AesirX Analytics:

copy icon
git clone https://github.com/aesirxio/analytics-1stparty.git

Instructions for setting up:

Clone the aesirx-1stparty.env.dist file into aesirx-1stparty.env and customize

    • You can choose not to customize anything.
    • If you have a separate MongoDB server, you can specify the credentials using the following variables:
      • DBUSER
      • DBPASS
      • DBHOST
      • DBPORT
      • DBNAME
    • You can choose to change the HTTP_PORT variable (default 80), which is the port that your 1st party server will listen to.

Execute docker compose up -d to run the full setup, including the MongoDB server.


Step-by-step guide:

Step 1: Create an AesirX Account

  • Visit https://signup.aesirx.io/.
  • If you don't have an AesirX account, click on the option to create one.
  • Enter your email address, choose a privacy ID, and select "Ethical Business Intelligence" from the Solutions drop-down menu.
  • Enter your domain name and click "Verify" to submit your request.
  • Check your email (including spam folder) for a confirmation message containing your license ID.

image5.png

Step 2: Install BI App

copy icon
git clone https://github.com/aesirxio/bi-app

Step 3: Setup Enviroment

In the aesirx-bi-app folder, rename the .env.dist file to .env

Note: To show the .env file on your computer, use:
MacOS: Ctrl + Shift + "."
Linux: Ctrl + H

- Replace the REACT_APP_CLIENT_SECRET  and REACT_APP_LICENSE in the .env file with the one provided in your profile account.

- Replace the REACT_APP_ENDPOINT_URL in the .env file with the link to your 1st party server for AesirX Analytics.

- Replace the REACT_APP_DATA_STREAM in the .env file with the name and domain to the your data-stream endpoint.

- Replace the REACT_APP_DEMO_USER in the .env file with the email you want to set for Login.

- Replace the REACT_APP_DEMO_PASSWORD in the .env file with the password you want to set for Login.

Step 4: Run App

1. Get submodules:

copy icon
git submodule update --init --recursive

2. Install & build dependencies:

- For yarn:

copy icon
yarn install
copy icon
yarn prepare

- For NPM:

copy icon
npm install --legacy-peer-deps
copy icon
npm run prepare

3. Build app

- For yarn:

copy icon
yarn build

- For NPM:

copy icon
npm run build

4. Run app

copy icon
docker compose -f "docker-compose.yml" up -d --build

When the app runs successfully, it will look like the image below

install_guide_7.png

-  Go to the browser

Enjoyed this read? Share the blog!