Skip to content

TrueConf Room deployment

TrueConf11/10/2626 min

Server deployment

Any video conferencing system consists not only of user applications, but also of a video conferencing server that exchanges data between these applications. Therefore, before configuring TrueConf Room, you need to create the server side of the system.

TrueConf Room can use TrueConf Online as a video conferencing server or an on-premises TrueConf Server (including its free version TrueConf Server Free).

All TrueConf servers use the SVC architecture for video conferencing, which allows efficient video transcoding between different types of devices.

In addition to meeting rooms, participants can join your conferences from personal devices, including mobile apps.

TrueConf Server also provides gateways that allow connecting real hardware video conferencing terminals (via SIP and H.323 protocols) and IP cameras (via RTSP protocol) to conferences.

If you are going to use the TrueConf Online service, you just need to register on our website and later sign in to TrueConf Room using your credentials.

The remainder of this section applies only to corporate TrueConf Server.

Take the following steps to get started with TrueConf Server:

  1. Download TrueConf Server or TrueConf Server Free. The benefits of the paid version can be found on our website.

  2. Install and launch the server following the instructions from its documentation.

  3. Create a user account for each meeting room. If you plan to connect participants' personal devices (computers, phones) to conferences or to share content during a conference, create user accounts for each of these devices. The number of user accounts is not limited.

  4. Check the connection to the server by connecting to it from a client application. If you want the server and TrueConf Room to be in different local networks or to communicate via the Internet using a router or NAT, configure the corresponding addressing in the server's local network and check the connection to it from outside the network.

Installing TrueConf Room on Windows

On the TrueConf Room page, click the Download for free button and fill in the registration form. Then click the Download TrueConf Room button.

On the Windows tab, download the TrueConf Room installer using the corresponding button and run it:

During the installation of TrueConf Room:

  1. In the Autorun options window, check the Run automatically box if you want the TrueConf Room Service service to be added to the OS startup. The service will then automatically launch the TrueConf Room terminal.

  2. Select the resolution of the background image to be displayed in the standby mode.

  3. Also, in the port selection window, you can specify a different port for accessing the control panel instead of the one already occupied by other software. This is not required if no third-party software besides TrueConf Room is installed on the PC (recommended usage).

  4. In the last window of the installer, uncheck Launch TrueConf Room and click Finish. This way the terminal window will not interfere with your further configuration.

After installing the terminal, additional OS configuration may be required when using a control tablet.

If you install TrueConf Room under a Windows OS user account without administrator rights and leave the Launch TrueConf Room checkbox checked in the last installer window, the link to the control panel on the main screen will be unclickable at first launch. In this case, you just need to restart TrueConf Room and the link will become active, or uncheck the Launch TrueConf Room checkbox.

Installing TrueConf Room on Linux

Step 1

On the page that opens after filling in the form, go to the Linux tab with a description of the further steps.

Click the link in the second item to open the detailed installation guide TrueConf Room for Linux on our blog. It covers installation both from a repository and manually from a file. The second method is described below.

Step 2

Download the installation package for your operating system.

Step 3

Go to the directory with the downloaded installation package and run the command as an administrator:

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

where trueconf-room-name is the file name.

During the installation you will be able to:

  • Specify a different port for accessing the control panel to avoid using the port that is already occupied by other software

  • Select a resolution for the video that will be displayed when the endpoint is in sleep mode

  • add TrueConf Room to startup.

Step 4

The trueconf-room-web web server will be added to the OS. It will start automatically after the installation.

From another computer on your local network, go to page TrueConf Room at http://[ip]:[port], where [ip] is the IP address of the computer running Linux, and [port] is the port specified in the previous step.

To check the IP address in Linux, run the ip a command.

The control panel is accessed via the port specified during installation. If this port is unavailable, you will need to configure another port manually.

To view the address and port for accessing the control panel, you can also launch TrueConf Room and check its main screen.

Configuring the endpoint without a touch panel

If TrueConf Room is used on a PC that is not connected to a touch panel for control, no additional actions are required.

Immediately after installation you can use the control panel which is accessible:

Configuring a terminal with a built-in or USB touch panel

The TrueConf Room terminal can be installed on a PC with a touch panel connected via USB or a built-in one. For example, on a Lenovo ThinkSmart Hub PC. In this case, automatic launch of the terminal control panel is configured on the touch panel, while the terminal windows are displayed on the large screen of the meeting room.

In this case, in addition to a PC, you will need:

  1. A touch panel connected to a PC via USB, such as Lenovo ThinkSmart Controller or Logitech Tap. The USB bus is also used to control the touch panel built into a PC, for example, on Lenovo ThinkSmart Hub. There are also panels that connect simultaneously to a USB port for control and to a video output for video display.

  2. A monitor or TV panel connected to a video output (e.g., HDMI or DisplayPort) intended for displaying the main screen of the endpoint.

  3. A keyboard and mouse are required to install and configure TrueConf Room. Once done, they can be disconnected.

Carefully follow the steps below; otherwise, we cannot guarantee that TrueConf Room will work correctly with automatic launch and proper screen distribution.

Configuration on Windows

OS configuration

Since the touch panel is recognized by the OS as a monitor, the following must be done for TrueConf Room to work correctly:

  1. Press Win + P to switch from dual-screen mode to extended display.

  2. Select the touch panel as the primary monitor. To check:

    • right-click on the desktop

    • select Display settings;

    • to identify which monitor is which, click the Identify button — monitors will display the numbers 1 and 2;

    • make sure that the touch panel is selected as the main monitor. For example, if the number 1 is displayed on the touch panel, select Display #1 and check Make this my main display if it is not enabled.

  3. On Windows 11, when the physical keyboard is detached, the touch keyboard will be automatically displayed, when you tap on a text field. On Windows 10, additional configuration is required to display the touch keyboard:

    • go to the Start → Settings → Devices menu;

    • select the Typing section;

    • Activate the Show the touch keyboard or handwriting panel when not in tablet mode and there's no keyboard attached toggle switch.

Setting up TrueConf Room Service

After installation, go to the Start menu in Windows and find the TrueConf Room Service folder in the list of installed programs. Run the settings program Settings TrueConf Room Service:

In the opened window, specify the following parameters:

  1. To configure the launch of the control panel TrueConf Room, select the section Web Manager and configure the following parameters:

  2. Select the Application section and choose a different monitor, e.g. Monitor #2, from the drop-down list for the Output device parameter. The number of the additional monitor was determined when configuring the OS.

  3. Click the OK button and restart your PC.

If everything is configured correctly, after the PC starts, the terminal control panel will automatically launch on the touch panel, and the main window of TrueConf Room will appear on the display, and you will be able to proceed with its configuration.

Configuration on Linux

OS configuration

As an example, let us consider Ubuntu.

Since the touch panel is recognized by the OS as a monitor, the following must be done for TrueConf Room to work correctly:

  1. Press Win + P to switch from dual-screen mode to extended display.

  2. Select the touch panel as the primary monitor. To check:

    • right-click on the desktop

    • select Display settings;

    • Make sure that the upper panel with menu and clock (Dock panel) is displayed on the touchscreen. It indicates that the touchscreen is selected as the main monitor. Otherwise, select a different display in the drop-down list from the Primary Display option.

  3. Add the command trueconf-room-service install to the auto start using any convenient method. For example, create a file ~/.config/autostart/start-room-service.desktop with the following text:

[Desktop Entry]
Name=Start Room Service
Exec=trueconf-room-service install
Type=Application
Hidden=false

If your clicks on the touch panel are registered on a different display, you will need to set up a correct mapping between input and output devices:

  1. To find out the ID of the input device (touchpad), run this command:

    xinput --list
  2. Memorize the id of your device in the Virtual core pointer section. If you can't identify the touch panel by name in this list, execute the command twice: first when the touch panel is disconnected and second when it is connected. Pay attention to the new device displayed on the screen. For example, if you received two lists:

    ⎡ Virtual core pointer                	id=2	[master pointer  (3)]
    ⎜   ↳ Virtual core XTEST pointer         	id=4	[slave  pointer  (2)]
    ⎜   ↳ ELAN0504:01 04F3:312A Touchpad     	id=22	[slave  pointer  (2)]

    and

    ⎡ Virtual core pointer                	id=2	[master pointer  (3)]
    ⎜   ↳ Virtual core XTEST pointer         	id=4	[slave  pointer  (2)]
    ⎜   ↳ ELAN0504:01 04F3:312A Touchpad     	id=22	[slave  pointer  (2)]
    ⎜   ↳ Touch Device pointer      	id=20	[slave  pointer  (2)]

    then your device is Touch Device pointer. Memorize its id (in this example, id=20).

  3. To find out the names of output devices, run the command:

    xrandr
  4. Identify your output device and remember the name of the corresponding interface (it will be one of the two marked as connected). If it is difficult to identify the touch panel unambiguously, do the same as in step 2: disconnect the touch panel, run the xrandr command, connect the touch panel and run the command again — the newly appeared device will be the one you are looking for.

    For instance, you received the output

    Screen 0: minimum 320 x 200, current 1920 x 2160, maximum 16384 x 16384
    HDMI-A-0 connected 1920x1080+0+0 (normal left inverted right x axis y axis) 344mm x 194mm
    ...
    DP-1 connected primary 1920x1080+0+1080 (normal left inverted right x axis y axis) 527mm x 296mm

    and judging by physical dimensions determined that the touch panel is connected to HDMI-A-0.

  5. To configure the mapping between the input and output areas, do the following:

    xinput --map-to-output <input_device_id> <output_device_name>

    where <input_device_id> is the input device (see step 2), and <output_device_name> is the output device (see step 4).

    In our example, the command will look like this:

    xinput --map-to-output 20 HDMI-A-0
  6. Make sure that tapping the touch panel now controls the image displayed on that same panel.

Configuring the virtual keyboard

Additional packages need to be installed on Linux to use the virtual keyboard in the control panel displayed on the touchscreen.

On Debian 10, the use of a virtual keyboard together with TrueConf Room is not available.

  1. Install the libqt5virtualkeyboard5 package:

    Ubuntu, Debian 11/12

    sudo apt-get install libqt5virtualkeyboard5
  2. Install the virtual keyboard:

Ubuntu, Debian 11/12

sudo apt install onboard

Setting up TrueConf Room Service

Go to the list of installed programs on Ubuntu OS and launch the Settings TrueConf Room Service utility from there. In the window that opens, configure the parameters in exactly the same way as shown above for Windows OS.

Android-based tablet

An Android-based tablet can also be used as a touch control panel connected to the same corporate network as the PC with the endpoint. To ensure better connection, we recommend specialized tablets with an RJ-45 port for a wired network connection, and not to use wireless Wi-Fi connection.

In this case, control is performed over the network using TrueConf Discovery.

  1. Install TrueConf Room on Windows or on Linux and do not make any additional OS settings.

  2. Connect the tablet to the same corporate network as the PC with the installed endpoint.

  3. Run TrueConf Room on your PC.

  4. In the tablet browser, go to the terminal control panel. To do this, use the address displayed on the main screen of the terminal.

  5. In the upper left corner of the control panel, click the /docs/room/media/gui/gear/en.png button to go to settings, and install TrueConf Discovery from the APK file as described in this section.

  6. Launch TrueConf Discovery and wait a few seconds until your instance appears in the list of terminals.

  7. Tap on your endpoint in the list. You will be able to control it with the same control panel interface that is available in the browser.

Configuring a static terminal address

The TrueConf Room software can be installed on any PC with a supported OS. By default, the OS often uses a dynamic IP address (the IP is obtained via DHCP). At the same time, TrueConf Room itself can be configured to run in the "always on top" mode with automatic restart at the TrueConf Room Service level.

If you need to change the network settings, for example to use a static IP address, you should first close the TrueConf Room window properly:

  1. Launch the terminal with the keyboard connected.

  2. Stop the TrueConf Room Service:

    • press the Win key on your keyboard;

    • Close the application window or right-click on /docs/room/media/gui/room-service/en.png in the system tray → Exit.

  3. Go to the system settings. You can do this using the system menu.

  4. In the Network section, find the row with the network card name, then click /docs/room/media/gui/network-setting/en.png → IPv4.

  5. In section IPv4 Method, select Manual to configure a static IP address. You can then specify Address, Netmask, and Gateway. To save the settings, click Apply.

  6. If necessary, you can specify a DNS server. Uncheck item Automatic and enter the corporate DNS server address. Click Apply to save.

  7. To verify the network settings:

    • Open the terminal and enter the command: ip a

    • Check if the inet line displays an IP address for the required network card.

Configuring a Static IP Address for a Desktop Tablet

A special desktop tablet with the TrueConf Discovery application installed can be used as a control interface for TrueConf Room. If the tablet is already connected to the control panel TrueConf Room, hold your finger on any area of the screen for 5 seconds and then tap /docs/room/media/gui/x/en.png.

In the pop-up window, click Exit.

The TrueConf Discovery interface will be displayed on the screen. To configure a static IP address:

  1. Click /docs/room/media/gui/gear/en.png → Device settings to go to the Android OS settings.

  2. Go to Network and Internet → Ethernet. In the Ethernet Ip mode section, select static.

  3. Specify the static IP settings.

  4. Click Connect. If the specified network parameters are correct, the entered address will be displayed in the IP address field.

Changing the port

If you need to change the port for accessing the TrueConf Room control panel after its installation, follow the instructions below.

For Windows

  1. Go to the C:\Program Files\TrueConf\Room\httpconf\conf\ folder and open the listen.conf file with any text editor (you have to open the file as the administrator).

  2. Change the port number in the Listen <port number> parameter, e.g., Listen 8888. Then, save the changes.

  3. Restart the TrueConf Room Web Manager service or reboot the PC where the software terminal is installed.

For Linux

  1. Go to the /opt/trueconf/room/etc/webmanager/conf/ directory as the superuser and open the listen.conf file with any text editor.

  2. Change the port number in the Listen <port number> parameter, e.g., Listen 8888. Then, save the changes.

  3. Restart the web server by running this command:

systemctl restart trueconf-room-web