# Installation and initial setup

# System requirements for TrueConf 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 role-based conferences for up to 20 participants connected via TrueConf client apps, including 4 speakers on the podium.
or
  • 1 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 role-based conferences for up to 20 participants connected via TrueConf client apps, including 4 speakers on the podium.
or
  • Up to 2 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 2008 R2/2012/2016/2019/2022 (including Core editions) with the latest updates installed
  • Debian 10 / 11
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.

# What is a registration key and how to get one?

Before installing TrueConf Server, please make sure you have a registration key. It is a unique secret combination of characters that identifies licenses for your TrueConf Server instance. You have probably received a registration key when downloading TrueConf Server from our official website or when purchasing it from one of our partners. In this case, skip this step and proceed to TrueConf Server installation process.

If you do not have a key, you can receive a free license by clicking the Download free version button on the TrueConf Server Free webpage.

A detailed comparison of the free and paid versions of TrueConf Server is available on the pricing page.

Here you will find a TrueConf Server Free download form:

/server/media/get_reg_key/en.png

A registration key will be sent to the email address that you provided.

You will receive the key within 15 minutes

If you did not receive the key, please contact us in any way convenient to you or check your SPAM email folder.

After filling out the form, select your operating system to get access to the corresponding installation guide.

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

# For Windows

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

/server/media/download_form/en.png

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.

/server/media/install_ports/en.png

Database port for server reports is set to 5432 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 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).

Can I install TrueConf Server on a PC with a web server already installed?

Yes. The installer will either automatically select available port, or give you the option to assign the port manually.

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.

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.

/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 trueconf-server-name is the file name.

For Debian:

apt install -yq ./trueconf-server-name.deb

Step 5.

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

Step 6.

The following TrueConf services will be added to the OS: trueconf-web web server, the main trueconf server service, the service of the manager needed for working with the database and trueconf-manager settings files. The web server and manager will 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

# Registration process

Register the server. To do this, you will need to enter the registration key you have received earlier.

Go back to the TrueConf Server setup page, enter your key in the corresponding field and click the Registration button:

/server/media/reg_key/en.png

If you do not have a key, click the Where do I get the key? link on the TrueConf Server registration page and follow the instructions above.

Once TrueConf Server has been successfully registered, you will see running, registered at the top right corner of the control panel window:

/server/media/status/en.png

# Offline registration

To register offline on a computer without an Internet connection, you will need a device connected to the Internet to obtain a registration key. On that device, go to trial registration page on our website and follow the instruction from the Registration section.

Once you have received an email containing your registration key, open the control panel on a PC without Internet connection, enter the key into the Registration Key field and press Registration:

/server/media/reg_key/en.png

Create registration file button will appear in the registration window. Click on it to generate a file with your registration information:

/server/media/registration_file_create/en.png

The generated file offlinereg.vrg will be saved in your browser’s Download folder. Please send the file to sales@trueconf.com. You will receive a file that needs to be installed on the PC with the offline-registered server.

Please do not try to restart offline registration until your receive a respond to your request. If you restart offline registration, you will need to retry the whole process.

Click on Select file and select file offline2.vrg. Then click Continue:

/server/media/offline_reg_file/en.png

If the offline registration has been successful, you will be notified that TrueConf Server has been successfully registered in the control panel.

# Changing the registration key

To change the registration key:

  1. Open Dashboard → Summary.

  2. Process the License info tab.

  3. Press Register and specify a new key, as shown above:

/server/media/registration_button/en.png

# Registration: Frequently Asked Questions

  1. Can I register TrueConf Server Free without an Internet connection?

    No, this feature is only available to those users who purchased annual or lifetime TrueConf Server license. If you need a trial version of TrueConf Server that operates without Internet connection, feel free to contact us.

  2. What should I do if I get the message Computer change is not available for this server code when changing the key?

    It means that your key is "bound" to the computer where the server was installed. To disable this binding, please contact us in any convenient way.

  3. What should I do if I get the message The registered server doesn't have valid licenses upon entering the key?

    It means either that the key has expired or the time and date on your PC have busted. Make sure that time and date are specified correctly on your PC.

# Control panel access settings

By default TrueConf Server can be administered from any computer in the same local network where it was installed. In other words, by default access is limited to the following ranges of IP addresses: 10.*, 192.168.*, 172.16-172.31, 127.*.

To get remote access to the TrueConf Server control panel, you need to sign in with an admin account. The admin is a member of one of the following groups:

  • TrueConf Server Admin for Windows (tcadmins for Linux) to manage TrueConf Server

  • TrueConf Server Security Admin for Windows (tcsecadmins for Linux) to view logs and conference recordings.

If you install TrueConf Server on Windows, your current account will be automatically added to the first group. For Linux, the users specified manually during the installation process are added to the tcadmins group. To make the control panel accessible to another user, the administrator should add this user’s account to one of the groups listed above.

If you use Windows, members of the Administrators group will also have admin access to the TrueConf Server control panel. For Linux, access to the control panel is given to the users specified when installing the server.

You can learn how to create a new user account on different operating systems and add it to the desired group on the example of TrueConf Server Security Admin in our documentation.

TrueConf Server does not impose any restrictions on the number of administrators of each type.

If an administrator wants to manage TrueConf Server from a remote computer, they need to make sure that the firewall allows incoming connections over the control panel access port (80 by default) and that this option has been enabled in the Security section of the TrueConf Server control panel.

Learn how to administer TrueConf Server outside your local network in our article.

# Server status

Server status is shown in the Server status field in green (if the server is working) or in red (if it has stopped) in top right corner of the control panel:

/server/media/status/en.png

What to do if server is not running?

Stopped status is displayed in the Server status string.

There are three possible reasons for this:

  • Invalid license: contact your system supplier to get a license.

  • Some server files are missing or have been damaged: reinstall TrueConf Server (see Installation)

  • The hardware key is invalid: check the manual to fix the hardware key issues.

# Server log

If you encounter any issues with TrueConf Server, TrueConf support team will be able to help you troubleshoot them more efficiently if you provide your server log files. To access the main log, go to System → Server log located in the top right corner of the control panel.

/server/media/journal_menu_button/en.png

Check Enable detailed logging in Dashboard → Settings section of the control panel to collect more detailed information in your server logs. Our technical support managers may ask you to do it to ease the troubleshooting process.

A range of additional log files is saved in the TrueConf Server working directory. Learn more about additional log files in our article.

# Configuring preferences

Some settings can be set up personally for each TrueConf Server administrator. e.g., control panel interface language, time zone, and reports export parameters.

/server/media/preferences/en.png
  1. Proceed to System → Preferences... in the upper right corner of the control panel.

  2. Select your language and time zone. Please note that the time zone will be applied to your meetings in all server logs and during the scheduling process. You can use the time zone of the computer where your TrueConf Server is installed by checking the corresponding box.

  3. You can set report export parameters (encoding and field delimiter to convert the table string to text format) in the Export to CSV section.

After making any changes make sure to click Apply button.

# Adding users

# Where can I find client applications

Send out the link to the guest page to your users to allow them to connect to your video conferencing system. They will be able to download client applications for any supported platform on the guest page.

The guest page is available at http[s]://<server>[:<port>] where:

  • <server> - address of the PC with TrueConf Server installed

  • <port> - port used to access the control panel (if you are using default 80 port, you don't need to specify it)

For example:

  • https://videoserver.company.com

  • http://100.120.12.12:7777

You can configure the guest page URL in the Web → Settings section of the control panel.

# How to connect client application to TrueConf Server

You need to specify the server address in the network settings of your client application so that your client application can connect to your TrueConf Server instance and your users can authorize. You can either do it manually or let your client application find the server automatically via DNS.

Once connected to the server user will be prompted to authenticate on this TrueConf Server instance with username and password.

# Client application manual setting

Users can configure connection to TrueConf Server manually. In order to do it, you need to specify the TrueConf Server address and connection port manually in the application network settings menu (or upon the first application launch). You can find detailed instructions on how to connect an application to the server on the guest page.

# Client application automatic settings

Desktop client applications can automatically search for local TrueConf Server instance. To make this possible administrator needs to specify the address of the server in primary DNS suffix by creating a new SRV record for vcs2 service.

The following example shows how to do this using DNS utility in Microsoft Windows 2012 Server:

  • Choose Other New Records… in a right-click menu

  • Choose type «Service Location (SRV)»

  • Set the following parameters.

/server/media/dns/en.png

In this example the TrueConf Server instance has videoserver.your.domain.com address and port 4307. Please make sure that protocol name (tcp) does not contain underscores.