Installing Eocortex Client application on Linux via Flatpak🔗
Compatible Linux distributions:
Debian 11, 12
Ubuntu 20.04, 22.04, 24.04
Operation on other Linux distributions is not guaranteed.
Note
The installation requires a graphical shell.
During the installation process, the computer must have internet access. This is necessary to download the necessary dependencies.
The entire installation must be done under a precreated user with administrator privileges (using sudo).
Without using sudo, the Eocortex Client will only be installed for the current user. Also, you may be required elevating the privileges during the components installation.
After installation, application shortcuts do not appear on the desktop but in the application menu of the system's graphical shell.
All commands for installing, updating, and uninstalling the Eocortex Client application should be executed in the terminal.
Warning
Recommended desktop environments: GNOME and KDE. When using MATE and the Marco window manager, modal windows and drop-down lists may not work correctly.
Below are the sequences of actions for installing, updating, and uninstalling the Eocortex Client application.
Online installation of the Eocortex Client🔗
To install Flatpak and the necessary dependencies, perform:
wget -O - https://packages.eocortex.com/flatpak/install/eocortex.sh | bash
Note
During the installation of Flatpak, all necessary dependencies and directories are downloaded, so the installation may take more than 5 minutes.
Select the required version from the list:
sudo flatpak remote-ls | grep com.eocortex.client
Note
The latest version contains the current version of Eocortex and is updated as new versions are released.
To ensure correct operation, install the same minor version of Eocortex Client as the Eocortex Server: if the Eocortex Server version is 4.1, then Eocortex Client must also be this version.
Install the Eocortex Client application:
sudo flatpak install eocortex com.eocortex.client//version_number
Example command for the latest version of Eocortex Client:
sudo flatpak install eocortex com.eocortex.client//latest
Example command for the 4.1 version of Eocortex Client:
sudo flatpak install eocortex com.eocortex.client//4.1
Then, it is necessary to re-enter the GUI or restart the PC so that the Eocortex Client shortcuts appear in the application menu.
Ofline installation of the Eocortex Client🔗
Warning
This method requires a computer with internet access (as well as an operating system and hardware) matching the one on which you intend to install Eocortex Client.
The entire installation must be done under a precreated user with administrator privileges (using sudo).
To download the dependencies and Eocortex Client, you will need a PC with internet access.
On the PC with internet access, the Flatpak dependencies and Eocortex Client files are downloaded. These must then be transferred to an external storage device;
On the PC without internet access, Flatpak, its dependencies, and the Eocortex Client itself are installed.
Steps to perform on the computer with internet access:
Run the script to download Flatpak and Eocortex Client, specifying the version (e.g., 4.1).
Warning
Please note that the script may take more than 10 minutes to complete; the execution time depends on the download speed of the required packages from the repository.
For Debian and Ubuntu:
wget -O - https://packages.eocortex.com/flatpak/install/flatpak-depends-deb.sh | bash -s 4.1
Upon completion of the script, an archive named flatpak.tgz will appear in the user's home directory. This archive must be transferred to the computer without internet access.
Install Flatpak on the computer without internet access:
Extract the archive:
tar xzvf flatpak.tgz
Install Flatpak on Debian, Ubuntu:
sudo dpkg -i flatpak_depends/*.deb
Install Eocortex Client on the computer without internet access:
cd flatpak_eocortex && bash install.sh
Then, it is necessary to re-enter the GUI or restart the PC so that the Eocortex Client shortcuts appear in the application menu.
Launch the applications🔗
Once the installation is complete, you can run the Eocortex Client, Eocortex Configurator and Eocortex Player applications.
At the first launch of the application it is necessary to select the interface language. After that the application initialization will start, which may take 5-10 minutes.
The interface of applications under Linux is similar to the interface of these applications under Windows.
Applications can be launched not only from the application menu, but also from the terminal.
Eocortex Client
flatpak run com.eocortex.client
Eocortex Configurator
flatpak run --command=runconfigurator.sh com.eocortex.client
Eocortex Player
flatpak run --command=runplayer.sh com.eocortex.client
Updating of the Eocortex Client🔗
To update the patch version (for example, from 4.2.74 to 4.2.91), run the following command:
sudo flatpak update com.eocortex.client
To update the minor version (for example, from 4.1 to 4.2), run the following command:
sudo flatpak install eocortex com.eocortex.client//4.2
Then, it is necessary to re-enter the GUI or restart the PC so that the Eocortex Client shortcuts appear in the application menu.
When you launch Eocortex Client, the initialization will start, which may take 5-10 minutes.
Uninstalling of Eocortex Client🔗
To uninstall the Eocortex Client, use the command:
sudo flatpak uninstall com.eocortex.client
To uninstall without saving settings or logs, run the following command:
sudo flatpak uninstall com.eocortex.client --delete-data
Automatic connection of Eocortex Client to Eocortex Server🔗
To set up an automatic connection of the Eocortex Client when running via a shortcut in the application menu, you need to specify the server IP address (or domain name), port, username, and password in the ~/.var/app/com.eocortex.client/data/client-flags.conf file.
Example:
-server office.server.com -port 8080 -user root -password qwerty
To connect via SSL, you must specify the port using the -ssl-port parameter instead of -port, and use the -connectionprotocol parameter with the value 1 to establish an HTTPS connection.
Example:
-server office.server.com -sslport 18080 -connectionprotocol 1 -user root -password qwerty
If you want to disable SSL-certificate validation, you can use the -disablesslcertificatesvalidation parameter.
Example:
-server office.server.com -port 8080 -disablesslcertificatesvalidation -user root -password qwerty
Working with MCM Files🔗
The player supports opening MCM files via double-click from the file manager.
Unsupported features🔗
Electronic signature of exported video and screenshots.
Auto-update of the client application.
Active Directory Single Sign-On.
View video in the camera's field of view on maps and plans.
View heat maps on plans.
Automatic opening of exported video.
Operation of Local monitoring and backup archive utility.
Installation of other Eocortex Client versions🔗
For example, if you want to upgrade from version 4.1 to 4.2, you must first install 4.2:
sudo flatpak install com.eocortex.client//4.2
and then upgrade to version 4.2 using the command:
sudo flatpak make-current com.eocortex.client//4.2
After that, you need to relaunch the graphical shell or restart your PC to update the shortcuts in the application menu.
When you run the Eocortex Client, the initialization process will occur again, which will take 5 or 10 minutes.
View a list of the current versions of Eocortex Client using the command:
sudo flatpak remote-ls | grep eocortex
Requirements, limitations, recommendations🔗
It is not recommended to use MATE with Marco window manager as a desktop environment due to peculiarities of behavior of this combination. When running Eocortex Client application in full-screen mode, the main window with camera cells is always placed on top of other windows (e.g. archive export or application settings) by default. The drop-down lists in Eocortex Client, Eocortex Configurator and Eocortex Player applications may not work correctly. As an alternative solution, it is recommended to use the Cinnamon desktop environment.
When using NVIDIA graphics cards for display, it is recommended to use proprietary drivers at least version 470.
Only USB connection is supported for PTZ remotes. Remote controllers connected by other means are not guaranteed to work.
Troubleshooting🔗
Problem 1🔗
Eocortex Client fails to install or start without displaying any errors.
The installation was not completed.
Ensure that the user has permission to install the application and that the computer has unobstructed access to the Internet. Delete the results of the previous application installation attempt, restart the computer and try again.
Problem 2🔗
Secondary application windows (Archive Export, Application Settings, etc.) do not open or open in the background.
A combination of the MATE graphical shell with the marco window manager is used, with which full-screen applications are always placed on top of other windows.
Switch to the desired window using the Alt+Tab key combination.
Change the MATE graphical shell to a different one. For example, cinnamon.
Problem 3🔗
The error "GPG verification enabled, but no summary found (check that the configured URL in remote config is correct)" appears during installation.
The repository metadata has changed.
Remove the flatpak repository Eocortex and add a new one:
sudo flatpak remote-delete eocortex
wget -O - https://packages.eocortex.com/flatpak/install/eocortex.sh | bash
Note
Suggestions and issue reports can be sent to support@eocortex.com.