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 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

2. The outputs should look like this for each command:
   1. Screen Shot Running: sudo apt install -y build-essential 
   2. Screen Shot Running: sudo apt update 
   3. Screen Shot of Successful: sudo apt upgrade 
3. 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.gzCopy

      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 Enterin 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)

Further reading