Step 3B: Evoko Home Installation on Ubuntu

Ubuntu Server Prerequisites

• A server running a 64-bit Debian based distribution (Ubuntu Server 20.04 LTS recommended).
• A static IPv4 address (the Evoko Liso units will point to this IP).
• Two free and accessible application ports (default HTTP port 3000 and HTTPS port 3002)
• A user with sudo permission
• Access to booking system (e.g. Office 365) over HTTP (port 80) or HTTPS (port 443).
• Access to NTP server over NTP (port 123 UDP).
• Access to the internet during installation to download dependencies.

 

 

Install Evoko Home on an Ubuntu Server

In this guide we will use Ubuntu Server 20.04 LTS as our operating system.

Text procedure

1. To ensure all basic build packages are available to run the installation script use the following three commands.  Press Enter on the keyboard after typing out each command: 

sudo apt install -y build-essential
sudo apt update
sudo apt upgrade

The outputs should look as follows for each command:

• Command output example: sudo apt install -y build-essential 

 

• Command output example: sudo apt update

 

• Output example: sudo apt upgrade

 

2. Download the latest version of Evoko Home for Linux and put the installation package on the server.  In this version, we will be downloading v2.7.4. Use one of the following two options.

• Option 1: download-liso.evoko.se

 

• Option 2: You can also download the latest Evoko Home version directly to the server by entering wget https://download-liso.evoko.se/latesthome.tar.gz​​​​​​ 

 

Download Complete :When the download is complete it should look like this 

 

3. Extract the downloaded installation package using one of the two following command options. 

• Command option 1 - if you downloaded it from our website:

tar -xzf installation_v2.*.tar.gzCopy

• Command option 2 - if you downloaded using the wget command:

tar -xzf latesthome.tar.gz

 

4. A directory v2.x.yz should now have been extracted. Check this by runningls Change directory to the newly extracted directory and run the installation script: 

cd v2.* && sudo bash install.sh

 

5. The installation script will automatically recognize the necessary tools/prerequisites required to run Evoko Home. To continue and install, select Yes by typing 1 and pressing Enter.

 

6. Next up is to create and record credentials for the Mongo database. It's in this database meetings, users and Evoko Home settings will be stored.

a. Set a username (for exampleevoko_user) and press Enter.

b. Then set a password (for example evoko_pass) which you repeat twice, pressing Enterin between.
sudo

• Documenting these database credentials is critical!  If the values are lost it, will be nearly impossible to recover any DB in case a future restore is needed.

 

7. You will then be prompted to accept the Database name: evoko_home_db 

 

8. Use localhost:27017 as the Address when prompted. 

 

Mongo restart: Mongo should restart and the directory structure should be created.

 

9. Next, type the HTTP application port (default 3000) and press Enter.

 

10. Set a memory limit for Evoko Home by typing the amount, for example 4096, and press Enter.

 

Successful Setup: If the setup is completed successfully, you should see the prompt shown in the image below.

 

Optional: You may now remove the installation files using the following command.

cd .. && sudo rm -r installation_v2.*.tar.gz v2.*

You should now be able to access Evoko Home via a web browser on the configured HTTP application port (default 3000). (localhost:3000)