Skip to main content

Citrix Client

Configuration

General Settings

Setting Value
Description Autostart

TranslationYes

pending.

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: <Manager-Home>/nfs/root/custom/icons

Use one of the following file formats: .png or .ico . Use a size of 32 × 32 or 64 × 64.

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, HTTP Basic Auth Enable it 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: 16500

    UDP Audio upper port Numeric

    For UDP audio, use a port between the lower port and the upper port.

    Default: 16509

    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.
    Webex 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 /dev/video-otc It's usually the correct one.

    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:

        Devices covered by a Virtual Channel driver Input devices, such as keyboards or mice Audio devices Webcams

        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 VID:PID or VID: Separate multiple entries with spaces. Specify only the vendor ID to include all devices from that manufacturer.

        Read USB IDs on the client in a terminal using the command lsusb .

        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
        as disabled 1 — use EUKS as a fallback method
        2 — use EUKS whenever possible

        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, /dev/ttyS0

            2nd serial port, /dev/ttyS1

            3rd serial port, /dev/ttyS2

            1st USB-to-serial adapter, /dev/ttyUSB0

            2nd USB-to-serial adapter, /dev/ttyUSB1

            3. USB-to-serial adapter, /dev/ttyUSB2

            /dev/ttyACM0

            /dev/ttyACM1

            Select the first port to be forwarded here.

            Second

            Disabled

            1st serial port, /dev/ttyS0

            2nd serial port, /dev/ttyS1

            3rd serial port, /dev/ttyS2

            1st USB-to-serial adapter, /dev/ttyUSB0

            2nd USB-to-serial adapter, /dev/ttyUSB1

            3. USB-to-serial adapter, /dev/ttyUSB2

            /dev/ttyACM0

            /dev/ttyACM1

            Select the second port to be forwarded here.

            Third

            Disabled

            1st serial port, /dev/ttyS0

            2nd serial port, /dev/ttyS1

            3rd serial port, /dev/ttyS2

            1st USB-to-serial adapter, /dev/ttyUSB0

            2nd USB-to-serial adapter, /dev/ttyUSB1

            3. USB-to-serial adapter, /dev/ttyUSB2

            /dev/ttyACM0

            /dev/ttyACM1

            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

              Reconnect session
              List of timeouts in s