Citrix Client
Configuration
General Settings
| Setting | Value |
Description |
|---|---|---|
| Autostart |
Yes No |
Select whether the application should start automatically after the thin client boots up. |
| Hide icon |
Yes Hide on desktop No |
Yes: Hide the application icon Hide on desktop: It'll place the icon in the menu and Run dialog. Show the application icon. Show the application icon |
| Custom icon | File name |
Here, assign a custom icon to the application. Save the icon on the openthinclient server in the folder: Use one of the following file formats: |
| After closing the application |
Leave settings unchanged Restart the application. Exit the Citrix application. Log out the user Restart the thin client Shut down the thin client Shut down ThinClient with Cancel dialog |
Select the desired action after all (previously started) Citrix sessions end. |
| Startup delay (in seconds) |
Numeric |
Delays the display of the login dialog by the specified number of s. |
Login settings
| Setting | Value | Explanation |
|---|---|---|
| Login |
Show Login Dialog Show login dialog with server address Use default login credentials Single sign-on Citrix-specific dialog |
Show Login Dialog / Show Login Dialog with Server Address: The system prompts for login credentials. Predefined login credentials: Use the login credentials entered in the Domain, Default User, and Default Password fields. Single sign-on: The application logs in directly using the Linux login credentials. Ensure the Thin Client Logincomponent's in use. Citrix-specific dialog: Use the login dialog of the Citrix Workspace app. This method lets users reset expired passwords. It's best to manually enter credentials, as field pre-filling isn't supported. On the server side, |
| Domain | Text |
This sets the domain for login when either "Show Login Dialog" or "Predefined Login Data" is selected in the Login setting. |
| Default User | Text |
This setting's used when the Login setting's value is Default Login Credentials. |
| Default Password | Text |
It's used when the Login setting is "Default Login Data". |
| Custom title of the login window | Text |
|
Storebrowse/Storefront Settings
| Setting | Value |
Explanation |
|---|---|---|
| Server / URL |
Text |
URL of the Citrix server. In most cases, specify the server name. The StoreBrowse client requires an SSL-encrypted HTTPS connection. Use a CA-signed certificate. See How to Export and Install an SSL Certificate for StoreFront to Use HTTPS |
| Citrix API |
StoreBrowse StoreFront |
The Citrix service handles authentication and delivers desktops and apps. For StoreFront, ensure StoreFront is active on the Citrix server and the configuration is accessible at https://servername/. (This is the default behavior of Citrix servers.) |
| Ignore login error and restart login |
Yes No |
Select here to restart the login dialog if the user’s credentials are incorrect or the user cancels the login dialog. Enabling this setting suppresses all error messages. |
| Reconnect session |
No Disconnected sessions Disconnected and active sessions Quick: Disconnected sessions Quick: Disconnected and active sessions |
Automatically open the user's previous sessions on this thin client. Disconnected sessions: Open sessions from which the user has disconnected while remaining logged on. Disconnected and active sessions: Opens both disconnected sessions and sessions that are still active on other clients. (These will be disconnected on the other client.) Quick: ...: As above, if Citrix API Storebrowse is selected, use the Storefront API to reconnect sessions. If the quick connection succeeds, use the "normal" functionality. |
| Automatically start a single application |
Yes No |
If this option is set to Yes and only one shared application exists, it'll start automatically. |
| Automatically start applications with a pattern in their name |
Yes Disable |
Select whether to automatically start all applications whose name contains the pattern specified in the next field. |
| Pattern | Pattern name |
|
| Desktops and Apps |
Show on Desktop Show Self-Service Window Hide icons |
Display on desktop: After launching and logging into the Citrix app, the icons for all applications and desktops available to the user are displayed on the desktop. Show Self-Service Window: Display only the self-service window, and let users configure which icons appear. Hide icons: Use this option with the autostart options. |
HDX and multimedia settings
To ensure that audio input and output work, enable them on the server side. In Citrix Studio, the following policy is available for this purpose:
- Client Audio Redirection (default: Enabled)
| Setting | Value |
Explanation |
|---|---|---|
| Audio Input |
On Off |
Select whether audio inputs (e.g., microphone) should be forwarded. Enable this setting to allow webcam forwarding. |
|
Default Audio Forwarding |
On Off |
On: All audio devices are forwarded Off: The default audio device is forwarded as Citrix HDX Audio |
| Client Audio Mapping |
Disable Low Quality Medium Quality High Quality |
Enables Client Audio Mapping. Client Audio Mapping is used when HDX MediaStream is unavailable. |
| Enable Adaptive Audio |
Yes No |
For older processors lacking Streaming SIMD Extensions (SSE), disable Adaptive Audio. |
| UDP Audio |
On Off |
If this setting is enabled, audio is transmitted via UDP instead of TCP/IP. Enable UDP Audio for digital dictation. |
| UDP Audio lower port | Numeric |
For UDP audio, the system uses a port between the lower and upper ports. Default: |
| UDP Audio upper port | Numeric |
For UDP audio, use a port between the lower port and the upper port. Default: |
| UDP via gateway |
To Off |
Enable the Datagram Transport Layer Security (DTLS) protocol for UDP audio; this lets UDP audio flow through Citrix Gateway. |
| HDX Windows Media Forwarding |
On Off |
Enable or disable Windows Media Redirection |
| Zoom Plugin |
On Off |
The Zoom Plugin optimizes webcam use with Zoom and works exclusively with the Zoom VDI Client. For more information and a download link for the Zoom VDI Client, see Getting Started with VDI. |
| Teams |
On Off |
Optimizations for Teams. |
|
On Off |
||
| Webcam Forwarding |
HDX Generic USB Forwarding Off |
HDX Webcam Forwarding (recommended): If you select this setting, the webcam image is compressed locally and sent to the server via the designated virtual channel. Generic USB Forwarding: The webcam stream is forwarded uncompressed. If the webcam outputs an H264 stream, network traffic stays efficient. If you enable this setting, the system ignores all quality settings configured below. |
|
HDX Webcam |
Automatic Negotiation Fixed resolution and frame rate |
Automatic negotiation Displays all connected cameras in the VDA and offers the resolutions supported by the cameras. Fixed resolution and frame rate Displays a "Citrix HDX Web Camera" with the properties listed below. |
| HDX Webcam Fixed Resolution | Width × Height |
Select the resolution of the webcam stream here. |
| HDX Webcam Fixed Frames per Second | Numeric |
Select the frame rate of the webcam stream here. |
| HDX Webcam Device |
If multiple webcams are connected to the thin client, select the desired webcam to forward. The default setting is usually |
USB Forwarding Settings
For Generic USB redirection to work, enable it on the server side. In Citrix Studio, the following policies are available for this purpose:
- Client USB Device Redirection (default: Allowed)
- Client USB Device Redirection for Plug and Play Devices (default: Allowed)
- Rules for Client USB Device Redirection
- Rules for USB client device optimization
| Setting |
Value |
Explanation |
| Enable Generic USB Redirection |
Yes No |
Select whether to forward all USB devices via Citrix's generic USB forwarding. With the "All except memory sticks" option, it'll forward all devices except USB storage devices. This option is particularly useful in combination with client drive mapping. The following devices are always handled locally:
|
|
Connecting devices |
Numeric |
USB IDs of devices that should always be forwarded directly to the session. This approach streamlines access by automating device redirection through Citrix policy and eliminating the need for user interaction. Note, enable Generic USB Redirection for this feature. USB IDs must be in the form Read USB IDs on the client in a terminal using the command |
| Exclude devices |
Numerically |
USB IDs of devices to include in generic forwarding. |
| Enable Grundig plugin |
Auto Yes No |
Select here whether the Grundig Virtual Channel driver should be enabled. |
|
Enable Olympus Plugin |
Auto Yes No |
Select whether to enable the Olympus Virtual Channel driver. |
| Enable Philips Speechmike Plugin |
Auto Yes No |
Select whether to enable the Philips Virtual Channel driver. |
| Enable Signotec plugin |
Auto Yes Yes |
Select whether the Signotec Virtual Channel driver should be enabled. |
Keyboard and Mouse Settings
| Setting | Explanation | |
|---|---|---|
| Keyboard Layout |
Automatic from client settings German German (Switzerland) French (Belgian) French French (Switzerland) Italian Spanish US |
|
| Keyboard type (Client) |
Automatic Linux |
|
| Keyboard type (server) |
Automatic IBM PC/XT |
|
| Keyboard parameter UseEUKS |
0 1 2 |
EUKS stands for Extended Unicode Keyboard Support 0 — configure EUKS |
| Enable paste with middle mouse button |
Yes Disable |
Yes: Middle mouse button sendsCTRLandV in the Citrix session Disable the feature to use the middle mouse button as a standard click in the Citrix session. Configure the middle mouse button to function as a middle mouse button in the Citrix session. |
| Keyboard shortcut processing |
Translated Use this setting only in full-screen mode. Direct |
Select whether to pass keyboard shortcuts directly. |
| Apply the fix for the mouse pointer issue. |
Yes No |
Select Yes if a black box appears around the mouse pointer. |
Client Drive Mapping
For client drive mapping to work, enable it on the server side. Citrix Studio provides the following policy for this:
- Client Drive Redirection (default: Enabled)
- Automatically connect client drives (default: enabled)
Additionally, configure generic USB redirection to exclude USB storage devices when mapping them.
| Setting | Values |
Explanation |
|---|---|---|
| Access permission |
Ask user Deny Read-only Read/Write |
|
| Enable drive mapping |
Yes No |
|
| Automatically map removable drives |
Yes Disable |
Mapping 1 and 2
| Setting |
Values |
Explanation |
| Mode |
Enable when required. Read-only Read/Write |
Select whether the statically mapped drive is forwarded as read-only or writable. |
| Windows drive letter | Text |
Select the drive letter for the statically mapped drive here. |
| Local Path | Text |
Select the path to be redirected here. |
COM Ports
For COM port redirection to work, enable it on the server side. Citrix Studio provides the following guidelines for this:
- Client COM Port Redirection (default: Allowed)
- Automatically connect client COM ports (default: disabled)
| Setting | Values |
Explanation |
|---|---|---|
| First |
Enabled 1st serial port, 2nd serial port, 3rd serial port, 1st USB-to-serial adapter, 2nd USB-to-serial adapter, 3. USB-to-serial adapter,
|
Select the first port to be forwarded here. |
| Second |
Disabled 1st serial port, 2nd serial port, 3rd serial port, 1st USB-to-serial adapter, 2nd USB-to-serial adapter, 3. USB-to-serial adapter,
|
Select the second port to be forwarded here. |
| Third |
Disabled 1st serial port, 2nd serial port, 3rd serial port, 1st USB-to-serial adapter, 2nd USB-to-serial adapter, 3. USB-to-serial adapter,
|
Select the third port to forward. |
Local Printers
If a local printer requires forwarding, first set it up (see Printers). Additionally, install the following printer driver in the VDA:
- HP LaserJet 2800 Series PS (Microsoft) [6.1.7600.16385]
Find instructions here: https://support.citrix.com/article/CTX140208
| Settings | Value |
Explanation |
|---|---|---|
| Enable |
Yes No |
Select here to allow forwarding from local printers. |
| Default printer |
Text |
Select the printer to set as the default printer in Windows. If the field remains blank, the system won't designate a default printer. |
| Driver for default printer |
Text |
Select the driver to use for the default printer. If the field remains blank, the system will select the HP LaserJet 2800 Series PS driver. If unsure, leave this field blank. |
| Printer List Client |
Text |
Select which local printers to forward. If the field's left blank, forward all local printers. |
Expert Settings
| Setting | Value |
Explanation |
|---|---|---|
|
Connection Bar |
Leave at default Always on Always off |
The Connection Bar allows the user to disconnect, switch between full-screen and windowed mode, or log out, among other things. |
| Desktop Appliance Mode |
On Off |
If Desktop Appliance Mode and generic USB passthrough are enabled, USB devices connected before the Citrix session begins are also passed through. If Desktop Appliance Mode is disabled, generic USB pass-through forwards only devices connected after the Citrix session started. |
|
Virtual NSAP Channel |
On Off |
|
| TUI Feature (Transparent User Interface) |
On Off |
|
|
Use Chromium to redirect browser content |
On Off |
|
| Tw2CachePower | ||
| TWRedundantImageItems | Numeric |
|
| Enable OSS |
Yes No |
|
| ApproximateColors |
Yes Disable |
|
| AllowBackingStore |
Yes Disable UseServerRedraw |
|
| UseServerRedraw |
Yes Disable |
|
| Enable Windows warning sounds | ||
| CPU Performance |
Default Maximum |
Implement workaround for Citrix Bug [RFLNX-1003]. |
| Logging |
Enable default logging. Detailed Information Warnings Errors Critical errors |
Automatic reconnection
| Setting | Value |
Explanation |
|---|---|---|
| Enable |
Yes No |
|
| Number of attempts |
Numeric |
|
| Delay between attempts |
Numeric |
Bitmap cache
| Setting | Value |
Explanation |
|---|---|---|
| Enable |
On Off |
|
| Size |
Numeric |
|
| Minimum size |
Numeric |
Font smoothing
| Setting | Value |
Explanation |
|---|---|---|
| Type |
0 — Setting from user profile 1 — None |
TLS settings
| Setting | Value |
Explanation |
|---|---|---|
| Minimum TLS Version |
1.0 1.1 1.2 1.3 |
|
| Maximum TLS version |
1.0 1.1 1.2 1.3 |
Connection Timeouts
Occasionally, individual actions in storebrowse may take a very long time or appear to hang. Here, enter timeouts after which the action will be aborted and retried. Specify multiple timeouts, e.g., 2,5,10). After the last timeout, execute the action without a timeout.
| Enumerate (List resources) | List of timeouts in s |
|
| List of timeouts in s |