Scout Enterprise Management Suite

Citrix Self-Service in kiosk mode (current eLux versions)

March 5, 2025

Contributed by:

S C

The Citrix Self-Service user interface with extensions is configured as kiosk mode. All relevant parameters are defined in the kioskmode.ini configuration file. Advanced functionality and MultiStore option are also configurable.

Defining Citrix Self-Service UI in kiosk mode

The eLux package Citrix Workspace-App for Linux must be installed on the devices.

The eLux package Citrix Extensions 2.x or later and the included feature package Self-service wrapper must be installed on the devices.

For modifications on the Citrix dialog design, further feature packages must be installed on the devices: Dialog Extension and Self-service dialog themes.

This may require modifications of the image definition file on the web server via ELIAS.

For the relevant devices, open [Advanced device configuration > Advanced file entries] and define the following entry:


File	`/setup/terminal.ini`
Section	Layout
Entry	`KioskMode`
Value	1

For further information, see Advanced file entries.

This parameter enables the kiosk mode for the Citrix Self-Service user interface with extensions.

Create a text file named kioskmode.ini and add the section header [Parameters]. Enter the relevant parameters:[1[[ ]Default values are displayed in bold]]

Parameter	Description
ReconnectOnLogon=true\|`false`	Determines whether the Self-Service UI tries to reconnect to all sessions for a given store, immediately after logon to that store (Citrix Self-Service option)
ReconnectOnLaunchOrRefresh=true\|`false`	Determines whether the Self-Service UI tries to reconnect to all sessions when an application is launched or the store is refreshed (Citrix Self-Service option)
SharedUserMode=true\|`false`	If the Shared User Mode is enabled, the Self-Service UI uses one technical user account for multiple users. The user data are removed from the device when users log off or close the UI. (Citrix Self-Service option) We recommend that you do not combine [SharedUserMode=false] and [Prelogin=true]
SelfSelection=true\|`false`	Is used to disable the search box and the Self-Selection panel (legacy UI). Disabling these UI elements prevents users from subscribing to extra applications.
LogoffMode=`0`\|1\|2\|3	0 = No automatic logoff 1 = Logoff timer is started with logon 2 = Logoff timer is started when the last Citrix app/desktop is closed 3 = Logoff timer is started when the first Citrix app/desktop is opened
LogoffDelay=`<seconds>`	Delay in seconds after the logoff timer is started
LogoffInfoTimeout=`<seconds>`	Shows a message for n seconds during logoff
ShowLastUser=true\|`false`	Shows last logged-on username in User field
PreLogin=true\|`false`	Determines, whether on logon a dropdown list with pre-configured stores is shown (MultiStore). We recommend that you do not combine `SharedUserMode=false` and [Prelogin=true]
PreLoginTitle	Dialog title for the stores list (MultiStore)
PassThroughMode=`0`\|1	0 No pass-through logon data 1 Active Directory UserPassword
Domain[<1-N>]=`<Domain display name,domain>`	Each entry contains a domain.

To define access to the stores, in the kioskmode.ini file, add one or more sections named [Store<1-N>] or [Environment_Store<1-N>].

If you define stores by using [Environment_Store<N>], users can switch between the stores by clicking the Store button on the taskbar. The Stores are shown in groups (Environment) as defined.

Parameter	Description
Url=`<Store URL>`	URL of the Citrix store
FriendlyName=`<Store display name>`	Display name for the Citrix store
Default=true\|`false`	Determines whether this store is displayed as default store
AutostartResources=`<App/Desktop1;App/Desktop2;...>`	List of Citrix applications/desktops to be started automatically after logon (Currently only available with `PreLogin=true`)

[Environment_Store<1-N>].

Parameter	Description
Url=`<Store-URL>`	URL of the Citrix store
FriendlyName=`<Display name>`	Display name for the Citrix store
Default=true\|`false`	Determines whether this store is displayed as default store
Environment=`<Group name>`	Specifies the group by which the stores are grouped (freely definable character string)
AutostartResources=`<App/Desktop1;App/Desktop2;...>`	List of Citrix applications/desktops to start automatically after logon (Currently only available with `PreLogin=true`)

To change the design of the Citrix dialogs for all Citrix connections, in the kioskmode.ini file, add a section named [Theme]:

Parameter	Description
ThemeName=`<Themes>`	Name of the Citrix theme. Default: `ucselfservice`
Decorated=true\|`false`	Determines whether the windows are shown with window decoration
ColorHover=`<RGB color code>`	Background color for list elements on mouse hover (Citrix list selection widgets). Default: `#e6f1f7`
ColorUnselected=`<RGB color code>`	Background color for unselected list items (Citrix list selection widgets). Default: `#ffffff`
ColorSelected=`<RGB color code>`	Background color for selected list elements (Citrix list selection widgets). Default: `#cce3f0`

Transfer the kioskmode.ini file to the devices to /setup/kioskmode.ini. To do so, use the Scout feature Files configured for transfer. For further information, see Files configured for transfer.

The terminal.ini entry along with the kioskmode.ini file on a device will cause the device to open the Citrix Self-Service interface in kiosk mode after start-up. All configured stores are available to the user. No other applications can be started apart from the self-service interface.

Note:

If more than one store is configured, users can switch between the stores by clicking the Store button on the taskbar while pressing Shift.

Example for [kioskmode.ini]

[Parameters]
ReconnectOnLogon=true
ReconnectOnLaunchOrRefresh=true
SharedUserMode=true
SelfSelection=false
ShowLastUser=true
LogoffMode=3
LogoffDelay=10

[Store1]
Url=<https://xd7a/int.sampletec-01.com/Citrix/Store/discovery>
FriendlyName=XenApp A

[Environment_Store1]
Url=<https://xd7b./int.sampletec-01.com/Citrix/Store/discovery>
FriendlyName=XenApp B
Default=true
Environment=PROD

[Environment_Store2]
Url=<https://xd7c./int.sampletec-01.com/Citrix/Store/discovery>
FriendlyName=XenApp C
Default=false
Environment=INT

[Theme]
ThemeName=ucselfservice
Decorated=false
ColorHover=#b0b0b0
ColorUnselected=#a0a0a0
ColorSelected=#c0c0c0
 

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Citrix Self-Service in kiosk mode (current eLux versions)

March 5, 2025

Contributed by:

S C

Citrix Self-Service in kiosk mode (current eLux versions)

Example for [kioskmode.ini]

In this article