# Installation and update. System requirements

# System requirements for the video conferencing server

	Basic configuration	Recommended configuration
CPU	Intel Core i3-8100 @ 3.6GHz Intel Core i5-7400 @ 3.0GHz Intel Xeon E-2234 @ 3.6GHz Intel Xeon W-2223 @ 3.6GHz or any other CPU with at least 4 logical cores and PassMark® CPU mark 7000+	Intel Core i7-10700 @ 2.9GHz AMD Ryzen 7 2700 @ 3.2GHz Intel Xeon E-2288G @ 3.7GHz Intel Xeon W-2245 @ 3.9GHz or any other CPU with at least 16 logical cores and PassMark® CPU mark 14000+
Typical configurations capabilities	Up to 200 online users connected via TrueConf client apps. Recording or streaming of one video conference of any type.	Up to 1,000 online users connected via TrueConf client apps. Recording or streaming of one video conference of any type.
	Plus
	1 all-on-screen conference for up to 36 participants connected via TrueConf client apps. or Up to 6 smart meetings or moderated role-based conferences for up to 20 participants connected via TrueConf client apps, including 4 speakers on the podium. or 1 smart meeting or moderated role-based conference for up to 240 participants (60 WebRTC connections and 180 client app users) with 5 speakers on the podium (2 WebRTC participants and 3 client app users). or Up to 25 WebRTC participants on screen in conferences of any type. or Up to 10 SIP/H.323 endpoints on screen in a conference of any type.	Up to 3 all-on-screen conferences for up to 36 participants connected via TrueConf client apps. or Up to 15 smart meetings or moderated role-based conferences for up to 20 participants connected via TrueConf client apps, including 4 speakers on the podium. or Up to 2 smart meetings or moderated role-based conferences for up to 240 participants (60 WebRTC connections + 180 client app users) with 5 speakers on the podium (2 WebRTC participants and 3 client app users). or Up to 36 WebRTC participants on screen in conferences of any type. or Up to 20 SIP/H.323 endpoints on screen in a conference of any type.
	Other examples of typical configurations →
GPU-based hardware acceleration	With NVIDIA Quadro P2000 (or a comparable graphics card), you can add 20 individual layouts for SIP/H.323 participants without changing other hardware.
Operating system	Dedicated or virtual 64-bit operating system: Microsoft Windows Server 2012/2016/2019/2022 (including Core editions) with the latest updates installed Debian 11 / 12 CentOS Stream 9 We do not recommend using vCPU overcommitment when deploying TrueConf Server on a VM (i.e., the number of vCPUs should not exceed the number of CPU threads on the host machine). To learn more about the recommendations for a VM, read this article. As part of configuration and setup services, we can deploy TrueConf Server on enterprise OS distributions that are not officially supported, such as Oracle Linux, Red Hat Enterprise Linux, Rocky Linux, etc. For more details, contact us in any convenient way.
RAM	16 GB	32 GB+
RAM	When installing memory modules, follow the motherboard manufacturer’s guidelines on how to maximize performance (such recommendations are usually provided for server hardware). Otherwise, as a general rule, we recommend using all memory channels available on the motherboard, in other words, you need to install at least one RAM stick for each channel.
Hard drive	20 GB of free space
Network	Ethernet 1 Gbit/s
Ports	Port 443 (can be changed in the control panel) is the default HTTPS port for transmitting service information between the server, client applications and browsers. If this port is closed, the following TrueConf client application features won't be available: *meeting scheduler* and *real-time meeting manager. Port 4307* (may be changed in TrueConf Web Manager) is used to exchange media data with client applications. Learn more →
IP	A static IP address is required for the server to work properly
Supported hypervisors	Microsoft® Hyper-V, Xen, KVM, Oracle VM VirtualBox, VMware Workstation and ESXi.

# Optimizing swap file usage

General recommendations for swap size on Windows and Linux:

Amount of installed RAM	Minimum swap amount	Recommended swap amount without hibernation	Recommended swap amount with hibernation
2-8 Gb	1-2 Gb	1 x RAM	1.5 x RAM
8-64 Gb	4-8 Gb	0.5 x RAM	1 x RAM
64-256 Gb	4-16 Gb	4-16 Gb	1 x RAM
>256 Гб	4-32 Gb	4-16 Gb	1 x RAM

If swap files are heavily used on a virtual or physical machine where TrueConf Server for Linux is installed, and there is plenty of available RAM, you can configure the OS settings for using swap files. As a general rule, Linux-based operating systems use swap files in the following way:

There is no single parameter for using swap depending on the percentage of RAM which is being used.
One should not rely on the mistaken belief that having a lot of RAM (e.g., 128 GB) means that you can do without swap: this file is an important part of memory management logic in the OS.
The use of swap is determined by the vm.swappiness parameter in the system file /etc/sysctl.conf. This parameter essentially represents the ratio between anonymous and physical memory pages. Physical pages correspond to files and their parts in the file system (typically, the code of running programs). Anonymous pages are dynamically created data (for example, variable values).
Reduction of vm.swappiness prioritizes anonymous memory over physical memory which decreases the use of swap.
By default, the value vm.swappiness = 60 works well on standard machines (with 8-16 GB of memory). However, machines, where TrueConf Server is installed, have more RAM, so it makes sense to choose a different value.

To learn more about swap in Linux, refer to the Red Hat website.

So, to reduce the use of swap, take these steps:

Open the /etc/sysctl.conf file with the administrator account in any text editor, for example, by executing the following command in the terminal:

sudo nano /etc/sysctl.conf

2. If the file already contains a line like vm.swappiness = 60, change the value 60 to a smaller number, for example 10. If this value is not included in the file, just add a new line vm.swappiness = 10.

Track the results under different loads (e.g., with a different number of conferences, etc.) and adjust the value, reducing it from 10 to 1. Do not set it to 0 under any circumstances. The final value may vary depending on the amount of RAM and the load on TrueConf Server during your test cases.

# Registration key validation

Before installing TrueConf Server, please make sure you have the registration key. You have probably received a registration key when downloading the installation file from our official website or when purchasing it from one of our partners. In this case, skip this step and start TrueConf Server installation. Otherwise, you will need to receive the key as it is described in the "Registration" section.

# Installation

TrueConf Server is distributed as a software installation package that contains the server side components and client applications for Windows PC. TrueConf client applications for other popular platforms are available on TrueConf website (alternatively, you can find the download links on the guest page).

If you are installing TrueConf Server Free behind the firewall, in order to complete the registration process you should open TCP port 4310 to allow access to our registration server located at reg.trueconf.com.

If you purchased a paid license, there is no need to open the port, and you will be able to register the software in offline mode.

# Which services will be added to the OS after installation

# Windows

TrueConf Server is the main service. It is responsible for the core functions of the video conferencing system: point-to-point calls, video conferences, messenger, etc.
TrueConf Database is a PostgreSQL database server service. The database stores chats and logs. The TrueConf Database service will not start if the TrueConf Server Manager service is not enabled.
TrueConf Web Manager is responsible for the operation of the TrueConf Server control panel, guest page, personal area, scheduler, web application (connecting to a conference through a browser via WebRTC). It also manages HTTPS settings. If this service is disabled, you will not be able to use the listed functions.
TrueConf Server Manager is a manager for working with the Windows Registry and configuration files. It is required for displaying certain data in the TrueConf Server control panel.
TrueConf Bridge is a service that receives WebSocket messages (commands) from web applications and converts them into transport messages understandable by TrueConf Server.

# Linux

trueconf — the main service, the server engine. It is responsible for the core functions of the video conferencing system: point-to-point calls, video conferences, messenger, etc.
trueconf-db is the PostgreSQL database service. This database stores all the TrueConf Server data: chats, user lists, conferences, groups, web server settings, etc.
trueconf-web is responsible for the control panel of TrueConf Server, the guest page, the personal area, the scheduler, the web application (WebRTC), and HTTPS settings. If this service is disabled, you will not be able to use the listed features.
trueconf-manager is a manager for working with databases and configuration files. It is required to display certain data in the TrueConf Server control panel.
trueconf-php — this service is responsible for processing certain scripts. It is an internal system service.
trueconf-bridge is a service that receives WebSocket messages (commands) from web applications and converts them into transport messages understandable by TrueConf Server.

# For Windows

After filling out the form, open the Windows tab and press Download TrueConf Server.

Download TrueConf Server

Download and run the distributive to start the installation. The installation process will take not more than a minute.

During the installation you can specify:

Web TCP port for accessing control panel over HTTP
TCP port of the database for server reports.

Database port for server reports is set to 5444 by default. It is selected during the installation process and cannot be changed afterwards (to change it you will need to re-install TrueConf Server). The control panel is given port 80 or 8888 (if port 80 is unavailable). If both port 80 and 8888 are unavailable, you will need to specify it manually during the installation process.

If after installation, the control panel cannot be opened via the specified port, it means that this port is probably used by another process. In this case you will need to select a different port manually.

If control panel port is not 80 (HTTP) or 443 (HTTPS), you need to specify it manually in the host name after the colon in the browser URL bar (e.g. http://localhost:8080).

Your browser will automatically open TrueConf Server control panel after installation.

# For Linux

Next, we will show the main steps for installing the software on Linux from the file (downloaded package). It is also possible to install from the repository. This installation method is described in the corresponding section of the article about the installation on each operating system.

TrueConf Server contains its own web server. To prevent any possible conflicts or clashes, please deploy TrueConf Server on a computer running on Linux without a pre-installed web server.

Step 1.

Add the user who will install TrueConf Server and get access to the TrueConf Server control panel to your OS. You can use the account that was created when installing your OS.

You cannot use trueconf as an OS username! This is because the OS will automatically create such a user to run certain TrueConf Server services. If such a user already exists, it needs to be removed.

Refer to the detailed installation guide in our blog to learn how a user can be created in Linux.

Step 2.

After filling out the form, open the Linux tab and proceed to our step-by-step guide on how to install TrueConf Server for Linux.

Click on the link in the second option to view the detailed guide in our blog on the installation of TrueConf Server for Linux.

Step 3.

Download the distribution for your operating system.

Step 4.

If you want to deploy TrueConf Server manually, open the directory with the downloaded installation package. Depending on your operating system, run one of the following commands as administrator, where server-installation-file is the file name.

For Debian:

apt install -yq ./server-installation-file.deb

For CentOS:

To make sure that TrueConf Server works correctly on CentOS, you will need to disable SELinux, the system can control the process access to the OS resources. To do it, run the following command as the administrator:

sed -i 's/^SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config

2. It is also necessary to connect the EPEL repository:

dnf install epel-release

3. Right after that, you can install TrueConf Server:

dnf install -y server-installation-file.rpm

When executing the installation command from a file on Linux, you can specify a list of users who will have access to the control panel without using the login window in an additional parameter. To do this, add the parameter TCADMINS_USERS=[users] to the installation command with a list of the required OS users, for example on Debian:

sudo TCADMINS_USERS=main_admin,second_admin apt install ./server-installation-file.deb

sudo TCADMINS_USERS=main_admin apt install ./server-installation-file.deb

Step 5.

During the installation, you will see a field for entering the names of OS users who will be allowed administrator-level access to the control panel. Specify the name of the user created earlier.

Step 6.

TrueConf services [described earlier](#services-linux) will be added to the OS. The web server and manager should start automatically after installation.

Use another computer in your LAN, open your web browser and type the IP address of the Linux-based computer with TrueConf Server installed. To find your IP address in Linux, run ip a command.

The control panel is given port 80 or 8888 (if port 80 is unavailable). If both port 80 and 8888 are unavailable, you will need to specify it manually during the installation process.

If control panel port is not 80 (HTTP) or 443 (HTTPS), you need to specify it manually in the host name after the colon in the browser URL bar (e.g. http://localhost:8080).

Refer to the article in our knowledge base to learn how to access the control panel when installing the software outside the local network (e.g., when installing on a cloud server).

Since TrueConf Server is not registered yet, an admin login page will be displayed instead of the guest page. Sign in with the user account you have previously created to start TrueConf Server registration.

# How to change the port to access the control panel without reinstalling TrueConf Server

For Windows OS

Go to the TrueConf Server installation directory (C:\Program Files\TrueConf Server by default).
Open the \httpconf\conf\listen.conf file using a text editor (administrator rights required).
Change the port number in the Listen <port number> parameter (e.g. Listen 8888) and save changes.
Open the \manager\etc\manager.toml file as an administrator and specify the same port in the parameter:

[web]
connection = "http://127.0.0.1:80"

For example, you can replace 80 port with 8888:

[web]
connection = "http://127.0.0.1:8888"

5. Please reboot the computer on which TrueConf Server is installed.

For Linux OS

If you use Linux, you cannot specify ports to access the TrueConf Server control panel during the installation process. If necessary, you can only change this port after the installation.

Go to the /opt/trueconf/server/etc/webmanager/ directory with superuser rights
Open the httpd.conf file with any text editor.
Change the port number in the Listen <port number> parameter (e.g. Listen 8888) and save changes.
Open the /opt/trueconf/server/etc/manager/manager.toml file with any text editor and specify the same port in the parameter:

[web]
connection = "http://127.0.0.1:80"

For example, you can replace 80 port with 8888:

[web]
connection = "http://127.0.0.1:8888"

5. Restart the trueconf-manager and trueconf-web services using these commands:

sudo systemctl restart trueconf-manager
sudo systemctl restart trueconf-web

# Video conferencing server update

TrueConf Server is updated with the help of installation files or repositories (on Linux). Please note that when updating the major version (the first two digits are changed, e.g., from 4.5 to 4.7 or from 4.7 to 5.0), you will need to re-register TrueConf Server because the hardware key (HW key) will change. Registration will also be needed if some of the following hardware parameters are changed on the physical or virtual machine where TrueConf Server is installed:

CPU model (please note that the number of virtual cores (vCPUs) does not affect the license)
Storage size (SSD or HDD)
Operating system.

For more details about updating TrueConf Server, refer to this article.

# 🆘 How to solve typical installation issues

# `gnupg` error when installing from the repository on Debian

If the following error is displayed in the terminal, when the software is installed from the repository on Debian:

E: gnupg, gnupg2 and gnupg1 do not seem to be installed, but one of them is required for this operation

it means that the gnupg encryption solution is not installed on the OS.

In this case install the missing package with this command:

sudo apt install gnupg2

If you type an incorrect or non-existing login when entering the administrator login during Step 5 of installation on Debian, installation may end with the following error:

E: Sub-process /usr/bin/dpkg returned an error code (1)

In this case, you will need to run this command on behalf of the superuser

echo PURGE | sudo debconf-communicate trueconf-server

Since you will clear the data about socket settings saved in the OS, refer to the official documentation (opens new window) for more details.

Next, restart installation from the first step.

# Unable to access the control panel

If you are unable to access the TrueConf Server control panel after installation, this problem may occur due to multiple reasons:

You are trying to access the control panel which is outside the local network (e.g., the server was installed on VPS).
The user, on whose behalf you are trying to sign in, does not have required permissions (please note that it has to be the OS user added to the corresponding group).
The password was changed for the OS user, who is the administrator of TrueConf Server, on CentOS Stream. In this case, run this command:

sudo setfacl -m u:trueconf:r /etc/shadow

Refer to our knowledge base to learn how one can solve the problem with access to the control panel.

An existing system account is used for accessing the TrueConf Server control panel, no new accounts are created during installation. Access is controlled by adding the selected OS accounts to a specific group. To learn more, refer to the description of control panel access settings.

← Licensing for the video conferencing server Registration →

# Installation and update. System requirements

# System requirements for the video conferencing server

# Optimizing swap file usage

# Registration key validation

# Installation

# Which services will be added to the OS after installation

# Windows

# Linux

# For Windows

# For Linux

# How to change the port to access the control panel without reinstalling TrueConf Server

# Video conferencing server update

# 🆘 How to solve typical installation issues

# gnupg error when installing from the repository on Debian

# Administrator login input error during installation

# Unable to access the control panel

# What are the default login and password of the administrator?

# `gnupg` error when installing from the repository on Debian