Install and set up your video conferencing server for Linux in 15 minutes

TrueConf Server for Linux is now available for Debian 11/12 and CentOS Stream 9. Enjoy the benefits of our enterprise-grade video collaboration platform on Linux distros! Only 64-bit versions of the OS are supported.

Choose your OS

This guide explains how to install and set up TrueConf Server for Linux.

Step 1. Download TrueConf Server for Linux and get your registration key

Fill in the TrueConf Server Free registration form. Press Submit & Download to receive your registration key on the email address you’ve specified.

Step 2. Set up your operating system

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.

Add a new user on Debian

1. Run this command
   adduser [user_login]

   1	adduser [user_login]

   where [user_login] is the login of the user who will be added.

2. When a command prompt is displayed, enter and confirm your password.
3. If necessary, you can provide additional information about the user, e.g., his/her full name, phone number, etc.

Step 3. Install TrueConf Server for Linux

Two installation options are possible:

• Install manually from the downloaded file (the repository will be automatically added to the list of sources needed for installing applications in the OS)
• Add the TrueConf repository to your system.

If you prefer the first option, select the Linux version to download the TrueConf Server installation package:

Debian 12

Debian 11

CentOS Stream 9

How to create a file on Linux

To install TrueConf Server from a repository, you will need to create a file with specified text in the system catalog of your operating system. You can do it both with your file manager and with your terminal by running the following command (it is necessary to use the administrator account or add sudo before tee):

where

[text] – the text to be added to the file

[file_path] – the file path.

For example, to create the file /etc/apt/sources.list.d/trueconf.list with this text deb https://mirror.trueconf.com/debian bullseye non-free, run the following command in the terminal:

For Debian

Manual install from the package

Proceed to the directory with downloaded TrueConf deb-package and start the installation by running the following command in the admin mode:

where trueconf-server-name.deb is the name of the installation package.

Install from repository

1. Create a file /etc/apt/sources.list.d/trueconf.list with the following content:
   printf "deb [arch=$(dpkg --print-architecture)] https://mirror.trueconf.com/debian $(lsb_release -cs) non-free" > /etc/apt/sources.list.d/trueconf.list

   1	printf "deb [arch=$(dpkg --print-architecture)] https://mirror.trueconf.com/debian $(lsb_release -cs) non-free" > /etc/apt/sources.list.d/trueconf.list

2. Run the sequence of the following commands in the admin mode:
   
   wget -O- https://mirror.trueconf.com/deb.trueconf.pub | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/trueconf.gpg --import

   1	wget -O- https://mirror.trueconf.com/deb.trueconf.pub | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/trueconf.gpg --import

   
   
   chmod 644 /etc/apt/trusted.gpg.d/trueconf.gpg

   1	chmod 644 /etc/apt/trusted.gpg.d/trueconf.gpg

   
   
   apt-get -y update

   1	apt-get -y update

   
   
   apt-get -y install trueconf-server

   1	apt-get -y install trueconf-server

   If the operating system does not have the gnupg cryptographic utility pre-installed, the following error will appear:
   

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

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

   In this case, install the missing package by running the following command:

   sudo apt install gnupg2

   1	sudo apt install gnupg2

For CentOS

Regardless of the installation method, you will need to take these preliminary steps:

1. Disable SELinux, the system that controls process access to OS resources. To do it, execute this command as the administrator:
   sed -i 's/^SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config

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

2. Connect the EPEL repository by running this command as the administrator:
   dnf install epel-release

   1	dnf install epel-release

Only at this point, one can install TrueConf Server.

Manual installation from the file

Go to the directory where the downloaded rpm package is stored. Next, run this command as the administrator to install the package:

where trueconf-server-name.rpm is the name of the installation package.

Installation from the repository

1. Create the file /etc/yum.repos.d/trueconf.repo with this record inside:
   [trueconf] name=TrueConf Repository baseurl=https://mirror.trueconf.com/centos-stream/$releasever/$basearch/release enabled=1 gpgcheck=1

   1 2 3 4

   [trueconf] name=TrueConf Repository  baseurl=https://mirror.trueconf.com/centos-stream/$releasever/$basearch/release     enabled=1 gpgcheck=1

2. Run these commands as the administrator:
   rpm --import https://mirror.trueconf.com/rpm-v3.trueconf.pub dnf install -y trueconf-server

   1 2	rpm --import https://mirror.trueconf.com/rpm-v3.trueconf.pub dnf install -y trueconf-server

Step 4. Add a user to get access to the control panel

When installing TrueConf Server on Debian, you will see a field will open where you will be able to enter OS user accounts who will have admin access to the TrueConf Server control panel. Enter the user account you’ve previously created.

If you have entered an incorrect username or non-existing login, the installation on Debian may end with the following error:

In this case you need to run the following command as a superuser:

This command will clear all the data about the package settings from the OS. Please check the official documentation for more details.

Then, start the installation process once again.

Step 5. Installation test

Multiple TrueConf services (called daemons in Linux) will be added to the OS. Two of them are the web server trueconf-web and trueconf-manager, the manager working with the database and settings files. They are supposed to start automatically after installation. Run the following commands to check their status:

If necessary, you can start them manually by running these commands:

The main trueconf service cannot be started until the server is registered. So, at first, one should configure access to the control panel.

Step 6. Access to the control panel

If you are within the local (corporate) network, take these steps:

1. Learn the IP address of the computer with Linux by running this command ip a.
2. From another computer within the local network, go to the page of the installed server by using its IP. Then, proceed to part 3.

If you are installing TrueConf Server on a remote computer outside the local network, e.g., a cloud-based virtual machine, you will need to edit the settings file to access the control panel. Due to security reasons, the control panel is available only inside the local network. To get access from outside, you will need to:

1. Learn the external IP address in the virtual machine control panel or by running the following command:
   curl ident.me; echo

   1	curl ident.me; echo

2. Open the file below with any text editor(e.g., vim) as an administrator:
   /opt/trueconf/server/etc/webmanager/opt/local_only_admin_24.conf

   1	/opt/trueconf/server/etc/webmanager/opt/local_only_admin_24.conf

3. Add this line Require ip x.x.x.x/32 where x.x.x.x is the external IP address. As a result, the file should look like this:
   <Location /admin> Require local Require ip 10.0.0.0/8 Require ip 192.168.0.0/16 Require ip 172.16.0.0/12 Require ip x.x.x.x/32 </Location>

   1 2 3 4 5 6 7 8 9 10 11 12 13

   <Location /admin>    Require local    Require ip 10.0.0.0/8    Require ip 192.168.0.0/16      Require ip 172.16.0.0/12    Require ip x.x.x.x/32 </Location>

4. Restart the TrueConf Server web service with this command:
   systemctl restart trueconf-web

   1	systemctl restart trueconf-web

Changing the access port for the control panel

By default, the server control panel is available via the standard HTTP 80 port and it does not have to be specified. However, if you cannot access the panel by IP, it means that the port 80 had already been taken at the moment when TrueConf Server was installed, and it is necessary to replace the port with a different one (e.g., 8080 or 8888).

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 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 connection parameter:
   [web] connection = "http://127.0.0.1:8888"

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

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

For Linux OS

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 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 connection parameter:
   
   [web] connection = "http://127.0.0.1:8888"

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

5. Please restart trueconf-manager and trueconf-web services using the following commands::
   sudo systemctl restart trueconf-manager sudo systemctl restart trueconf-web

   1 2	sudo systemctl restart trueconf-manager sudo systemctl restart trueconf-web

After changing the port and restarting the web service, try again to access the control panel.

Step 7. Register your server

1. Since Trueconf Server is not registered yet, an admin login page will first be displayed when accessing by IP (check step 6). Sign in with the user account you have previously created:
   
2. On the page that opens enter your registration key in the corresponding field and register your server.

If you want to update TrueConf Server to a major version (the first two digits change, e.g., from 4.5 to 4.7 or from 4.7 to 5.0) you will need to re-register your TrueConf Server instance. Contact our technical support in any convenient way and share your server ID for us to reset the binding. After that you can re-register your TrueConf Server instance with your key.

Step 8. Start your server

After you’ve registered your server, it will restart automatically. The corresponding message will be displayed in the Server status field.

You can also view your server status directly in Linux by running the following command:

Step 9. Add user accounts and create video conferences

The process of adding user accounts and creating video conferences is described in detail in our TrueConf Server for Windows installation guide.

More useful articles

Find other helpful guides on TrueConf software solutions in our knowledge base.

If you have any questions, please contact us at sales@trueconf.com or reach us by phone at +1 (833) 878-32-63. We are always happy to help!