Below you will find a description of how to install Intrexx in Linux.
Target audience
The description is intended for people who have a basic understanding of the administration of computers with Linux as the operating system. In particular, you should be familiar with permissions assignment on Linux.
Linux distribution
The examples in the following description refer to Ubuntu 22.04. Installation on other Linux distributions is done analogously. However, you may need other programs, such as editors or Linux system tools, to manage or check permissions or services.
Headless server – Server with GUI support
The following is a description of both the installation on a headless server and on a server with GUI support.
The commands for a headless server and a Linux server with a graphical interface differ only by a "-t" at the end of the command. For example, if you type "setup.sh -t", the corresponding routine will be executed via the Linux terminal.
If you are using a Linux server with a graphical interface, you can omit the "-t". Afterwards, Intrexx's graphical installation routine will start. The dialogs displayed here essentially correspond to the dialogs in the Intrexx installation under Windows.
Architecture
When installing Intrexx on a Linux server, this description assumes that you are installing the Intrexx server on the Linux server. The Intrexx Portal Manager, which users use to connect to the Intrexx Portal Server, is installed on a Windows computer. This scenario is often used in practice.
However, you can also install the Intrexx Portal Manager on a Linux computer and connect to the Intrexx Portal Server from there.
By default, the Integrated Portal Manager is installed on the Linux server at the same time as the Intrexx Server. So after installation, you can immediately start the Portal Manager Serverr) on the Linux server and perform administrative tasks, for example.
Further information on the architecture of Intrexx can be found in section Intrexx architecture.
Front-end web server
To run a live portal, you must use a front-end web server. If you are running Intrexx on Linux, this is usually NGINX. In the course of installing Intrexx, you will be asked which front-end web server you would like to use to run Intrexx.
More information about using NGINX is available in the chapter Linux - Configure NGINX.
Database
For a functional portal you need a database. Very often PostgreSQL is used on Linux. The installation of the database is not directly required to install Intrexx. However, you will need a database as soon as you create a portal.
For detailed information about PostgreSQL, please refer to the following section Install PostgreSQL on Linux.
Permissions and services
Services
The following service is available after Intrex has been installed:
Solr The "Solr" service provides the search function within a portal.
After creating a portal, a portal service still exists. This service always has the name you specify for your portal. If you are running multiple portals, each portal has its own service.
Intrexx services after installation
-
Solr
Additional Intrexx services after creating a portal
-
exampleportal (If you have called your portal "exampleportal").
More information about creating a portal is available in the following section Create a portal on Linux.
Permissions
To create, start and stop services, root privileges are required on Linux. For this reason, the Intrexx installation and the execution of updates must be performed by a user who has root privileges or belongs to the Sudoers group.
(The exception is if you install Intrexx separately from Intrexx services. In this case, Intrexx can be installed by a user without root privileges or who does not belong to the Sudoers group. We recommend this option for highly experienced Linux or Intrexx users only. For more information, see the section Installing Intrexx and Intrexx services separately - Install Intrexx without root rights)
Root permissions and security issues
In general, installing software with a user who has root permissions can raise security issues. After installation, services may then run under root and the associated files can only be edited with root permissions.
For this reason, you can choose between a root variant and an intrexx user variant for installing Intrexx. You can make an appropriate selection during the installation routine.
root installation
If you can or would like to install and run Intrexx in an isolated environment, then follow the "root installation". This method does not pose a safety risk in isolated environments.
A VM where you run Intrexx exclusively can serve as an isolated environment. Furthermore, you can run Intrexx in a Docker container. This also allows you to rule out security risks associated with root privileges.
For more information about deploying Intrexx in a Docker container, see the following section Deploy Intrexx in Docker.
Intrexx user installation
The main concern with the intrexx user installation is that the Intrexx files that will be available after the installation belong to the intrexx user and not to root.
Linux user
For the intrexx user installation, you must log in to the Linux server where you want to install Intrexx with a user that has (temporary) root permissions. As an administrator of a Linux server, you usually log in with such a user for your everyday work. Typically, this user belongs to the Sudoers group and can execute commands with sudo.
If you do not have a user who belongs to the Sudoers group, but would like to install Intrexx, then contact your administrator. The adminstrator must add your user to the Sudoers group.
In the scenario assumed here, the Linux user corresponds to a physical person who administrates the Linux server and also installs software in this context.
Intrexx user
For the intrexx user installation, you need a "technical" user in addition to the Linux user. This user does not correspond to a physical person. The user is used exclusively in connection with the Intrexx services on Linux. You can give this user any name you want. In the following sections, the name "intrexx" is used for this user.
You should create the "intrexx" user before installing Intrexx. It does not need to have any special permissions or a home directory.
The following sections will provide you with a step-by-step guide for installing Intrexx on Linux. Both the root installation and the intrexx user installation are described.
Email us