Step 3: Evoko Home installation

Evoko Home can be installed on both Windows and Linux (Debian based) servers.
The installation procedure depends on the operating system therefore please select the type of operating system which you will install Evoko Home.

• Step 3a: Windows
• Step 3b: Linux

Step 3a: Windows

This part will go through how to install Evoko Home on a Windows server.

Windows server prerequisites

• A server running Windows Server 2016 (or later).
• 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)
• 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).

Install Evoko Home on a Windows server

This part will go through how to install Evoko Home on a Windows server.

1. Download the latest version of Evoko Home for Windows to the server.
   
2. You will need to run this installer as an Administrator.  To do so, right click on the downloaded file and click Run as Administrator.
   
   
   
3. This will trigger the "single installer" which will help you install correct versions of additional software (e.g. Node.js, MongoDB etc) required to run Evoko Home.  You will want to agree to license agreement and press install.
   
4. Once the installation is finished you will be prompted to finalize the Evoko Home installation wizard.  Press "Next"
5. You will be prompted on where you would like the service to be configured.  We recommend keeping the location to the default file path of the C: drive.  Press Next.
6. You will then be prompted to input credentials for MongoDB.  This is where all information will be stored regarding your Evoko Home instance.  It is extremely important to document these database values as if they are lost it will be nearly impossible to recover any DB in case a future restore is needed!  After the values are added; press Next

Note!

DB characters not allowed in Windows: /\."$*'<>:|?  and empty space

DB characters not allowed in Linux: /\.'"$ and empty space

The reason for these limitations is the new backup/restore functionality.

1. 
   
   
2. Once the values for your database have been input click "Next" and then proceed with "Install"
3. Click finish when the installation is complete.
4. Once the installation is complete, verify that the service is running under services.msc.
   
5. Look for a service named ERM Service and make sure its status is Running.
   
6. If the service is running and no firewall blocking, access Evoko Home via http://localhost:3000
   

Step 3b: Linux

This part will go through how to install Evoko Home in on a Linux server.

Linux 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 a Linux server

In this guide we will use Ubuntu Server 20.04 LTS as our operating system which we connect to via SSH.

1. To ensure all basic build packages exist to run the installation script we recommend running the following three commands.  Press enter on the keyboard after each command:
   

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

   Screen Shot Running: sudo apt install -y build-essentialScreen Shot Running: sudo apt update Screen Shot of Successful: 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
   1. Option 1: download-liso.evoko.se
      
   2. 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. When the download is complete it should look like this:
3. Extract the downloaded installation package: 
   Option 1 - if you downloaded it from our website:

   tar -xzf installation_v2.*.tar.gz

   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, you can check this by running ls.
5. Change directory to the newly extracted directory and run the installation script: 

   cd v2.* && sudo bash install.sh

6. 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.
   
7. Next up is to create credentials for the Mongo database. It's in this database meetings, users and Evoko Home settings will be stored. Set a username (e.g. evoko_user) and press Enter. Then set a password (e.g evoko_pass) which you repeat twice, pressing Enter in between.
   sudo
8. You will then be prompted to accept the Database name: evoko_home_db -
9. Use localhost:27017 as the Address
10. Mongo should restart and the directory structure should be created.
11. Next you will need to type the HTTP application port (default 3000) and press Enter.
    
12. Set a memory limit for Evoko Home by typing the amount e.g. 4096 followed by pressing Enter.
    
13. Below should be prompted if setup is successfully completed, you may remove the installation files:

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

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