How to install the latest IceWarp EPOS on Linux

This article describes the installation of IceWarp Epos on a Linux server. Remember to check the supported OS distributions in our release notes.

PREPARATION STEPS

It would be best if you had your OS to be at least Rhel7 - Centos distribution. However, it is recommended to use Rhel8 - Centos Stream 9 or RockyLinux 9 distributions because of the support versions by the providers of these operating systems. Then you would need basic knowledge of the Linux command such as wget, cd, cat, how to run bash scripts, etc. With this common knowledge, you can install EPOS on your Linux server.

If you have an older version of IceWarp for example version 11.X.X.X. Here are the steps on how to upgrade your IceWarp server before you upgrade your server to the EPOS version with links to every single version.

If you have an older version than version 11.0.0.0. we recommend a new installation.

The whole installation process is running in the Terminal, without a graphical window you may be used to from Windows operating systems.

Before you start installing, please open up the "Terminal" application.

To enhance the functionality of EPOS, it is advisable to transition from SQLite to the latest MariaDB before upgrading to EPOS. This will help overcome the constraints of SQLite, including the incapability to support foreign keys, among others.

API CHECK

The latest version requires successfully passing the API check to make sure the server is accessible from outside for its latest feature called Dashboard. This is the initial step for each installation of EPOS.

This check opens two sessions simultaneously; wherein the first session, the client contacts our Dashboard microservice in our cloud and introduces itself. It continues to tell your server to provide the Smart Discover settings next.

In the second session, the server will try to contact your server through the Smart Discover settings and provide an answer in the first session.

There is an option to skip this check, but the recommended steps are to find out why you cannot reach our API. Issues will likely be in your infrastructure, so we recommend you look at the firewall and Smart Discover settings. The last thing is to ensure the communication is getting through both ways.

To skip the check, please enter the following command. However, please keep in mind that this will make the Dashboard unavailable when the server starts after the installation.

 "./install.sh --skip-api-check"

There is another skip of check called "skip-ffmpeg-check" used for creating a preview of videos. The command will look like this

"./install.sh --skip-ffmpeg-check"

INSTALLATION STEPS

1. Download EPOS from our website and unzip it via Terminal with the command "unzip"
2. Enter the folder with the command "cd" and run the installation file "./install.sh"

The first thing that will pop up is the new license agreement. Please read it carefully and confirm by "Enter" to continue.

In the next step, decide where will the installation folder be stored.

Choose the user under which IceWarp will run.

Press "Enter" to continue and choose if you want to run IceWarp on the startup.

Choose your hostname.

In the next steps, you can create a domain and admin account.

Follow the next steps related to your license.

If you already have one, you can write "n" to the text field and proceed with your current license.

If you do not have one, feel free to write "Y". After that, you will be redirected to a different page where you have to fill out the form and be provided with a trial license.

We already have a license, so we go for "n" and "Y" afterwards.

Once you enter the license, you should see the message "License activation successful".

the following URL https://your_hostname/admin/#menu=server_settings&tab_server_settings=fulltext_search

And last but not least, just remember that the configuration is set to default, and you will have to adjust it to your needs and requirements.