TrueConf Server Admin Guide

# Installation and upgrade. 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
RAM 16 GB 32 GB+
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.

# 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 have purchased a paid license, it is not necessary to open the port and you will be able to use offline registration.

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

/docs/server/media/download_form/en.png
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.

/docs/server/media/install_ports/en.png

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

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.

Check the full installation guide in our blog to learn how to create a user in Linux (see Step 2).

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.

/docs/server/media/linux_form/en.png

Read our step-by-step guide to learn how to download and install TrueConf Server for Linux.

Step 3.

Download your preferred Linux distribution.

For each operating system, there is also an option to install TrueConf Server from the repository. You can find a detailed description on how to do that in the corresponding section of our article.

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:

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

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

Check Step 6 in our knowledge base article to learn how one can access the control panel from outside the local network (e.g., when installing the software 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

  1. Go to the TrueConf Server installation directory (C:\Program Files\TrueConf Server by default).

  2. Open the \httpconf\conf\listen.conf file using a text editor (administrator rights required).

  3. Change the port number in the Listen <port number> parameter (e.g. Listen 8888) and save changes.

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

  1. Go to the /opt/trueconf/server/etc/webmanager/ directory with superuser rights

  2. Open the httpd.conf file with any text editor.

  3. Change the port number in the Listen <port number> parameter (e.g. Listen 8888) and save changes.

  4. 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. Please restart the web server service using the following command:

systemctl restart trueconf-web

# Upgrading the video conferencing server

Updating TrueConf Server is also done via installation files or (on Linux) via repositories. Please note that when updating major version (the first two digits change, for example, 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 required if the configuration of the following hardware on a physical or virtual machine with TrueConf Server is changed:

  • processor model (note that the number of virtual cores (vCPU) does not affect the license)

  • storage size (SSD or HDD)

  • the operating system used.

To learn more about connection options, check our article.

← Registration →