# Knowledge Base **URL:** https://community.thinlinc.com/c/knowledge-base/6.md [Latest](https://community.thinlinc.com/latest.md) · [Categories](https://community.thinlinc.com/categories.md) · [Tags](https://community.thinlinc.com/tags.md) --- ## [About the Knowledge Base category](https://community.thinlinc.com/t/about-the-knowledge-base-category/18)
**Author:** [@cendio](https://community.thinlinc.com/u/cendio)\ **Replies:** 0
Questions, tips, tricks and general information about ThinLinc and related components. Topics in this category should be useful enough to be considered FAQesque. --- ## ["No X11 desktop environments installed" error on RHEL 10, AlmaLinux 10, and Rocky 10](https://community.thinlinc.com/t/no-x11-desktop-environments-installed-error-on-rhel-10-almalinux-10-and-rocky-10/1553)
**Author:** [@wilsj](https://community.thinlinc.com/u/wilsj)\ **Replies:** 12\ **Last updated:** [16 October 2026 11:47 UTC](https://community.thinlinc.com/t/no-x11-desktop-environments-installed-error-on-rhel-10-almalinux-10-and-rocky-10/1553 "2026-10-16T11:47:11Z")
Starting with version 10, Red Hat Enterprise Linux and RHEL-based distributions no longer include a traditional X server. Consequently, the /usr/share/xsessions/ files required by ThinLinc are not available through the s… --- ## [Why do my ThinLinc sessions get killed when I restart or upgrade the agent service?](https://community.thinlinc.com/t/why-do-my-thinlinc-sessions-get-killed-when-i-restart-or-upgrade-the-agent-service/2076)
**Author:** [@wilsj](https://community.thinlinc.com/u/wilsj)\ **Replies:** 0\ **Last updated:** [14 September 2026 11:08 UTC](https://community.thinlinc.com/t/why-do-my-thinlinc-sessions-get-killed-when-i-restart-or-upgrade-the-agent-service/2076 "2026-09-14T11:08:55Z")
Restarting vsmagent.service, or upgrading ThinLinc, is supposed to leave running sessions uninterrupted. Every so often we get a question in our support channels from someone whose experience contradicts this, usually du… --- ## [Why does starting multiple ThinLinc sessions as the same user sometimes fail?](https://community.thinlinc.com/t/why-does-starting-multiple-thinlinc-sessions-as-the-same-user-sometimes-fail/160)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 9\ **Last updated:** [22 July 2026 01:51 UTC](https://community.thinlinc.com/t/why-does-starting-multiple-thinlinc-sessions-as-the-same-user-sometimes-fail/160 "2026-07-22T01:51:57Z")
One feature of ThinLinc is the ability to start and manage multiple sessions as the same user. When logging in with the native client, if you already have one or more existing sessions on the server, then you have the op… --- ## [Why does ThinLinc try to connect to a different IP address than the one specified?](https://community.thinlinc.com/t/why-does-thinlinc-try-to-connect-to-a-different-ip-address-than-the-one-specified/618)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 4\ **Last updated:** [18 May 2026 21:30 UTC](https://community.thinlinc.com/t/why-does-thinlinc-try-to-connect-to-a-different-ip-address-than-the-one-specified/618 "2026-05-18T21:30:42Z")
After installing a new ThinLinc server and connecting to it for the first time, you may encounter an error message like this: Looking at the logs, you might find that the ThinLinc client is attempting to connect to an… --- ## [Error: No executable profiles could be found](https://community.thinlinc.com/t/error-no-executable-profiles-could-be-found/40)
**Author:** [@samuel](https://community.thinlinc.com/u/samuel)\ **Replies:** 7\ **Last updated:** [22 December 2025 10:28 UTC](https://community.thinlinc.com/t/error-no-executable-profiles-could-be-found/40 "2025-12-22T10:28:58Z")
One common support issue we get is about the error message “No executable profiles could be found” that appears when trying to login to a ThinLinc session. The most common cause of this is that a session cant start beca… --- ## [Dividing ThinLinc licenses over multiple clusters](https://community.thinlinc.com/t/dividing-thinlinc-licenses-over-multiple-clusters/1789)
**Author:** [@wilsj](https://community.thinlinc.com/u/wilsj)\ **Replies:** 0\ **Last updated:** [31 October 2025 14:54 UTC](https://community.thinlinc.com/t/dividing-thinlinc-licenses-over-multiple-clusters/1789 "2025-10-31T14:54:16Z")
When purchasing a ThinLinc subscription, some have the need to divide the associated ThinLinc licenses over multiple separate ThinLinc clusters. This article describes how that can be done. Dividing a license bundle Whe… --- ## [How do I prevent Polkit authentication dialogues from popping up when I start a ThinLinc session?](https://community.thinlinc.com/t/how-do-i-prevent-polkit-authentication-dialogues-from-popping-up-when-i-start-a-thinlinc-session/1552)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 2\ **Last updated:** [21 October 2025 11:50 UTC](https://community.thinlinc.com/t/how-do-i-prevent-polkit-authentication-dialogues-from-popping-up-when-i-start-a-thinlinc-session/1552 "2025-10-21T11:50:56Z")
On some distributions, users may be presented with Polkit authentication dialogues when starting a ThinLinc session. While harmless, these can be annoying, and confusing for users who don’t know what they mean. One comm… --- ## [How does the ThinLinc load-balancer work?](https://community.thinlinc.com/t/how-does-the-thinlinc-load-balancer-work/157)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 1\ **Last updated:** [14 October 2025 08:31 UTC](https://community.thinlinc.com/t/how-does-the-thinlinc-load-balancer-work/157 "2025-10-14T08:31:49Z")
Note: this article describes the load-balancer in ThinLinc version 4.18.0 and earlier. ThinLinc can be installed and configured in a number of different ways. For example, an administrator may install ThinLinc on a sing… --- ## [Is it possible to limit resource usage for ThinLinc users?](https://community.thinlinc.com/t/is-it-possible-to-limit-resource-usage-for-thinlinc-users/1717)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [19 August 2025 04:18 UTC](https://community.thinlinc.com/t/is-it-possible-to-limit-resource-usage-for-thinlinc-users/1717 "2025-08-19T04:18:33Z")
Introduction One common question with terminal server solutions like ThinLinc, where multiple users are often sharing the same hardware, is how to allocate resources fairly. If one user runs a resource-intensive task, th… --- ## [Is ThinLinc available for free usage?](https://community.thinlinc.com/t/is-thinlinc-available-for-free-usage/1660)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [7 July 2025 23:06 UTC](https://community.thinlinc.com/t/is-thinlinc-available-for-free-usage/1660 "2025-07-07T23:06:24Z")
ThinLinc is a commercial, fully-supported product which generally requires the purchase of user licenses for production use. However, in order to simplify evaluation and reduce cost for smaller installations, we do allow… --- ## [Why are some environment variables not being set within my ThinLinc session?](https://community.thinlinc.com/t/why-are-some-environment-variables-not-being-set-within-my-thinlinc-session/1563)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [26 May 2025 21:00 UTC](https://community.thinlinc.com/t/why-are-some-environment-variables-not-being-set-within-my-thinlinc-session/1563 "2025-05-26T21:00:43Z")
ThinLinc has a specific mechanism for setting environment variables within a ThinLinc session - the /vsmagent/default\_environment parameter. This can be used to set environment variables in users’ ThinLinc sessions, in a… --- ## [Running the ThinLinc client on ARM64 Linux](https://community.thinlinc.com/t/running-the-thinlinc-client-on-arm64-linux/1506)
**Author:** [@wilsj](https://community.thinlinc.com/u/wilsj)\ **Replies:** 1\ **Last updated:** [15 April 2025 14:39 UTC](https://community.thinlinc.com/t/running-the-thinlinc-client-on-arm64-linux/1506 "2025-04-15T14:39:01Z")
Edit: We now ship native ARM64 binaries of the ThinLinc client. This post has been archived. Currently, the ThinLinc client only ships as a 32-bit binary (armhf) for Linux on ARM. This client is still compatible with AR… --- ## [How to set up authentication in ThinLinc with PKCS #15 smart cards](https://community.thinlinc.com/t/how-to-set-up-authentication-in-thinlinc-with-pkcs-15-smart-cards/408)
**Author:** [@samuel](https://community.thinlinc.com/u/samuel)\ **Replies:** 1\ **Last updated:** [9 April 2025 04:13 UTC](https://community.thinlinc.com/t/how-to-set-up-authentication-in-thinlinc-with-pkcs-15-smart-cards/408 "2025-04-09T04:13:50Z")
This tutorial uses Fedora 36. It assumes that you have the ThinLinc server, and a ThinLinc client installed. ThinLinc Administrator’s Guide about this: 1. Install the necessary drivers for smart card readers on your… --- ## [How do I prevent the legacy menu from appearing in Firefox when using ThinLinc?](https://community.thinlinc.com/t/how-do-i-prevent-the-legacy-menu-from-appearing-in-firefox-when-using-thinlinc/1503)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [8 April 2025 22:23 UTC](https://community.thinlinc.com/t/how-do-i-prevent-the-legacy-menu-from-appearing-in-firefox-when-using-thinlinc/1503 "2025-04-08T22:23:08Z")
If you use Firefox within your ThinLinc session, you may have noticed the “legacy menu” appearing sporadically. This menu is shown at the very top of the Firefox window in the following screenshot (“File”, “Edit”, “View”… --- ## [Hardening TLS configuration](https://community.thinlinc.com/t/hardening-tls-configuration/1004)
**Author:** [@samuel](https://community.thinlinc.com/u/samuel)\ **Replies:** 1\ **Last updated:** [4 April 2025 00:15 UTC](https://community.thinlinc.com/t/hardening-tls-configuration/1004 "2025-04-04T00:15:02Z")
ThinLinc uses GnuTLS for Web Access and Web Admin. By default, it allows TLS versions 1.0, 1.1, 1.2 and 1.3: https://www.cendio.com/resources/docs/tag/gnutls-priorities-standard.html In some cases, you might want to ha… --- ## [Which username and password do I use to log into the web administration interface?](https://community.thinlinc.com/t/which-username-and-password-do-i-use-to-log-into-the-web-administration-interface/1497)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [1 April 2025 00:52 UTC](https://community.thinlinc.com/t/which-username-and-password-do-i-use-to-log-into-the-web-administration-interface/1497 "2025-04-01T00:52:43Z")
The ThinLinc server bundle provides a web administration interface called tlwebadm, which can be used to configure various aspects of the ThinLinc server. This interface runs on port 1010 of the ThinLinc master server, a… --- ## [How to set up One-Time-Password (OTP) authentication in ThinLinc](https://community.thinlinc.com/t/how-to-set-up-one-time-password-otp-authentication-in-thinlinc/409)
**Author:** [@samuel](https://community.thinlinc.com/u/samuel)\ **Replies:** 8\ **Last updated:** [16 February 2025 03:20 UTC](https://community.thinlinc.com/t/how-to-set-up-one-time-password-otp-authentication-in-thinlinc/409 "2025-02-16T03:20:09Z")
This is a tutorial that will go through the steps to enable two-factor authentication, OTP, and user password for logins to your ThinLinc system. ThinLinc uses the underlying Linux authentication mechanism PAM to authent… --- ## [Why do I get stuck on a splash screen when starting a ThinLinc session?](https://community.thinlinc.com/t/why-do-i-get-stuck-on-a-splash-screen-when-starting-a-thinlinc-session/1094)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 7\ **Last updated:** [12 February 2025 01:10 UTC](https://community.thinlinc.com/t/why-do-i-get-stuck-on-a-splash-screen-when-starting-a-thinlinc-session/1094 "2025-02-12T01:10:53Z")
When connecting to ThinLinc, users may be presented with a blue and white splash screen instead of a desktop session: The underlying cause of this is poor support for running multiple desktop sessions as the same use… --- ## [Is it possible to limit the lifetime of a ThinLinc session?](https://community.thinlinc.com/t/is-it-possible-to-limit-the-lifetime-of-a-thinlinc-session/951)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 4\ **Last updated:** [7 January 2025 06:18 UTC](https://community.thinlinc.com/t/is-it-possible-to-limit-the-lifetime-of-a-thinlinc-session/951 "2025-01-07T06:18:16Z")
One benefit of terminal server solutions like ThinLinc is the ability to have persistent sessions. Users can log in, start a job, disconnect at any time, and come back later to pick up where they left off. This is especi… --- ## [Create a custom executable Profile (Zorin, Budgie, Pop!\_Os, etc)](https://community.thinlinc.com/t/create-a-custom-executable-profile-zorin-budgie-pop-os-etc/1226)
**Author:** [@matre](https://community.thinlinc.com/u/matre)\ **Replies:** 0\ **Last updated:** [16 December 2024 08:19 UTC](https://community.thinlinc.com/t/create-a-custom-executable-profile-zorin-budgie-pop-os-etc/1226 "2024-12-16T08:19:32Z")
Many desktop environment work seamlessly with ThinLinc, as long as it supports X11, and these are shipped with premade profiles ready to use. However not everyone is bound by the shackles of conventional distros and ma… --- ## [What is my ThinLinc username and password?](https://community.thinlinc.com/t/what-is-my-thinlinc-username-and-password/1128)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [9 October 2024 01:40 UTC](https://community.thinlinc.com/t/what-is-my-thinlinc-username-and-password/1128 "2024-10-09T01:40:46Z")
One problem new users sometimes have after installing ThinLinc is not knowing which username and password to log in with. In short, ThinLinc uses whatever authentication mechanism (or mechanisms) the server OS is configu… --- ## [How to conveniently switch between different user profiles](https://community.thinlinc.com/t/how-to-conveniently-switch-between-different-user-profiles/863)
**Author:** [@linn](https://community.thinlinc.com/u/linn)\ **Replies:** 1\ **Last updated:** [16 February 2024 11:47 UTC](https://community.thinlinc.com/t/how-to-conveniently-switch-between-different-user-profiles/863 "2024-02-16T11:47:16Z")
Different user profiles for the ThinLinc client can be useful when regularly connecting to multiple different ThinLinc servers, e.g. to save the hostname of the server, swap between different authentication methods or us… --- ## [Can ThinLinc be used to access Windows-based remote desktops and applications?](https://community.thinlinc.com/t/can-thinlinc-be-used-to-access-windows-based-remote-desktops-and-applications/523)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 3\ **Last updated:** [8 March 2024 09:00 UTC](https://community.thinlinc.com/t/can-thinlinc-be-used-to-access-windows-based-remote-desktops-and-applications/523 "2024-03-08T09:00:48Z")
ThinLinc is primarily focused on providing remote access to Linux-based desktops and applications, from a wide range of client devices. By focusing on Linux specifically, we are able to dedicate more time and effort towa… --- ## [How do I uninstall the ThinLinc server?](https://community.thinlinc.com/t/how-do-i-uninstall-the-thinlinc-server/859)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [12 February 2024 21:21 UTC](https://community.thinlinc.com/t/how-do-i-uninstall-the-thinlinc-server/859 "2024-02-12T21:21:58Z")
ThinLinc ships with an installer script which makes server installation simple and straightforward on most Linux distributions. The script can be used at both the command line and GUI, and also supports using an “answer … --- ## [What does the HOST\_ALIASES parameter of the ThinLinc client do?](https://community.thinlinc.com/t/what-does-the-host-aliases-parameter-of-the-thinlinc-client-do/852)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [8 February 2024 01:13 UTC](https://community.thinlinc.com/t/what-does-the-host-aliases-parameter-of-the-thinlinc-client-do/852 "2024-02-08T01:13:45Z")
The ThinLinc client supports a large number of configuration options, the most useful of which are able to be set via the GUI. Other, less common options can either be passed at the command line, or via a plain-text conf… --- ## [Running a single app using ThinLinc](https://community.thinlinc.com/t/running-a-single-app-using-thinlinc/847)
**Author:** [@frifl](https://community.thinlinc.com/u/frifl)\ **Replies:** 0\ **Last updated:** [5 February 2024 14:32 UTC](https://community.thinlinc.com/t/running-a-single-app-using-thinlinc/847 "2024-02-05T14:32:56Z")
Sometimes you don't need to run a complete desktop in your ThinLinc session. In that case, you can run a single application instead. This tutorial shows three ways to set up ThinLinc to run just one program instead of an… --- ## [Is it possible to manage sessions from the command line?](https://community.thinlinc.com/t/is-it-possible-to-manage-sessions-from-the-command-line/782)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [20 November 2023 02:25 UTC](https://community.thinlinc.com/t/is-it-possible-to-manage-sessions-from-the-command-line/782 "2023-11-20T02:25:52Z")
Following on from our previous article “Is it possible to retrieve detailed session information at the command line?”, with the release of ThinLinc 4.15, a new tool tlctl has been made available for managing sessions at … --- ## [Does ThinLinc support publishing single applications as well as desktops?](https://community.thinlinc.com/t/does-thinlinc-support-publishing-single-applications-as-well-as-desktops/585)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 1\ **Last updated:** [19 September 2023 09:07 UTC](https://community.thinlinc.com/t/does-thinlinc-support-publishing-single-applications-as-well-as-desktops/585 "2023-09-19T09:07:06Z")
This article introduces publishing single applications with ThinLinc, and discusses some of the benefits and limitations of doing so. Introduction Each ThinLinc session is built around a server-side process called Xvnc.… --- ## [How can I customise the desktop environment within a ThinLinc session?](https://community.thinlinc.com/t/how-can-i-customise-the-desktop-environment-within-a-thinlinc-session/717)
**Author:** [@aaron](https://community.thinlinc.com/u/aaron)\ **Replies:** 0\ **Last updated:** [14 September 2023 10:02 UTC](https://community.thinlinc.com/t/how-can-i-customise-the-desktop-environment-within-a-thinlinc-session/717 "2023-09-14T10:02:48Z")
Using ThinLinc’s profile selector, it is possible to provide users with a choice of desktop environments (DEs) when starting a new ThinLinc session. This can be useful when users have a strong preference for a certain ty… [Next page](https://community.thinlinc.com/c/knowledge-base/6.md?page=1)