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
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 port3002
) - Access to booking system (e.g. Office 365) over HTTP (port
80
) or HTTPS (port443
). - 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.
-
Download the latest version of Evoko Home for Windows to the server.
- You will need to run this installer as an Administrator. To do so, right click on the downloaded file and click Run as Administrator.
- 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.
- Once the installation is finished you will be prompted to finalize the Evoko Home installation wizard. Press "Next"
- 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.
- 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.
-
- Once the values for your database have been input click "Next" and then proceed with "Install"
- Click finish when the installation is complete.
- Once the installation is complete, verify that the service is running under
services.msc
. - Look for a service named
ERM Service
and make sure its status isRunning
. - If the service is running and no firewall blocking, access Evoko Home via
http://localhost:3000
Once Evoko Home is installed move on to Step 4: Connect Evoko Home to booking system
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 port3002
) - A user with
sudo
permission - Access to booking system (e.g. Office 365) over HTTP (port
80
) or HTTPS (port443
). - 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 16.04 LTS as our operating system which we connect to via SSH.
- To ensure all basic build packages exist to run the installation script we recommend running:
Screen Shot Running: sudo apt install -y build-essentialsudo apt install -y build-essential sudo apt update sudo apt upgrade
Screen Shot Running: sudo apt update
Screen Shot of Successful: sudo apt upgrade
-
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.5.1
You can also download the latest Evoko Home version directly to the server by enteringwget https://download-liso.evoko.se/latesthome.tar.gz
. - Extract the downloaded installation package:
Option 1 - if you downloaded it from our website:
Option 2 - if you downloaded using the wget command:tar -xzf installation_v2.*.tar.gz
tar -xzf latesthome.tar.gz
- A directory
v2.x.yz
should now have been extracted, you can check this by runningls
. - Change directory to the newly extracted directory and run the installation script:
cd v2.* && sudo bash install.sh
- 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 pressingEnter
. - 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 pressEnter
. Then set a password (e.gevoko_pass
) which you repeat twice, pressingEnter
in between. - You will then be prompted to accept the Database name: evoko_home_db -
- Use localhost:27017 as the Address
Mongo should restart and the directory structure should be created.
- Next you will need to type the HTTP application port (default
3000
) and pressEnter
. - Set a memory limit for Evoko Home by typing the amount e.g. 4096 followed by pressing
Enter
. - Below should be prompted if setup is successfully completed, you may remove the installation files:
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
).
Once Evoko Home is installed move on to Step 4: Connect Evoko Home to booking system