Articles in this section

How to install IceWarp EPOS on Linux

Avatar
Tomas Truneček
  • Updated
Follow

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

PREPARE

We recommend using RHEL 9 (with RHEL 8 as the last supported version). As alternatives, you can also use CentOS Stream 9 or Rocky Linux 9—all of which are well-supported and compatible with EPOS.

To get the best performance and stability from EPOS, we also recommend migrating from SQLite to MariaDB after finishing the installation. SQLite has certain limitations, such as the lack of support for foreign keys, which MariaDB overcomes, allowing for improved functionality and scalability.

INSTALLATION

Download EPOS from our website and extract it anywhere on the destination server.

 Info

To ensure your server can be reached from outside we recommend not skipping the API check.

This confirms that your server is accessible from outside. In case you cannot ensure accessibility  of your server from outside 

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 could probably 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.

API Check Troubleshooting

 

 Info

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

Run

./install.sh

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

Screenshot_2023-02-08_at_11.46.23.png

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

Screenshot_2023-02-08_at_11.46.38.png

Choose the user under which IceWarp will run, you can press "Enter" to use the default option.

Screenshot_2023-02-08_at_11.46.47.png

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

Screenshot_2023-02-08_at_11.49.11.png

Choose your hostname.

Screenshot_2023-02-08_at_11.50.01.png

In the next steps, you can create a domain and admin account.Screenshot_2023-02-08_at_11.42.05.png

Screenshot_2023-02-08_at_11.42.13.png

Screenshot_2023-02-08_at_11.42.24.png

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.

Screenshot_2023-02-08_at_11.43.18.png

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

Fulltext Search

To configure YODA full-text search service and related functionality, please visit the following URL:
https://your_hostname/admin/#menu=server_settings&tab_server_settings=fulltext_search

Finally, the settings are default, so change them as needed.

Related articles

Comments

0 comments

Article is closed for comments.