Get started

Set up

You can download the installation package, customize the configuration, and then install the Citrix Workspace app.

You can modify the contents of Citrix Workspace app package and then repackage the files.

Customize installation

  1. Expand the Citrix Workspace app package file into an empty directory. The package file is called (for example, linuxx86.13.2.0.nnnnnn.tar.gz for the Linux/x86 platform).
  2. Make the required changes to the Citrix Workspace app package. For example, you can add a TLS root certificate to use a certificate from Certificate Authority that is not a part of the standard Citrix Workspace app installation.
  3. Open the PkgID file.
  4. Add the following line to indicate that the package was modified:


    where, traceinfo is information indicating who made the change and when.

  5. Save and close the file.
  6. Open the package file list, platform/platform.psf (for example, linuxx86/linuxx86.psf for the Linux/x86 platform).
  7. Update the package file list to reflect the changes you made to the package. Not updating might cause error when installing the new package. Changes can include updating the size of any files you modified, or adding new lines for any files you added to the package. The columns in the package file list are:
    • File type
    • Relative path
    • Subpackage (always set to cor)
    • Permissions
    • Owner
    • Group
    • Size
  8. Save and close the file.
  9. Use the tar command to rebuild Citrix Workspace app package file. For example, tar czf ../newpackage.tar.gz *, where newpackagez is the name of the new Citrix Workspace app package file.

Latest webkit support

Citrix Workspace app for Linux requires libwebkit2gtk (2.16.6+).

libwebkit2gtk has the following advantages:

  • Improved UI experience. webkit2gtk is compatible with the browser content redirection feature. Use webkit2gtk Version 2.24 or later for an even better YouTube viewing experience.
  • webkit2gtk Version 2.16.6 and later improves the sign-in experience and the time it takes to sign in.
  • The app works better with newer Linux distributions and provides with the latest webkit security fixes.


webkit2gtk is not available on some Linux distributions. As a workaround, consider the following options:

  • Build webkit2gtk from the source before installing Citrix Workspace app 1906.
  • Move to a later Linux distribution that supports webkit2gtk 2.16.6 or later.


You can start Citrix Workspace app either at a terminal prompt or from one of the supported desktop environments.

Ensure that the environment variable ICAROOT is set to point to the actual installation directory.


The following instruction does not apply to installations made from the Web packages, and where the tarball is used. This instruction is applicable when the requirements for self-service have not been met.

Terminal prompt

To start the Citrix Workspace app at the terminal prompt, type: /opt/Citrix/ICAClient/selfservice

And press Enter (where /opt/Citrix/ICAClient is the directory in which you installed Citrix Workspace app).

Linux desktop

You can start the Citrix Workspace app from a desktop environment using a file manager.

On some desktops, you can also start Citrix Workspace app from a menu. Citrix Workspace app is located in different menus depending on your Linux distribution.


To set preferences, click Preferences from the Citrix Workspace app menu. You can control how desktops are displayed, connect to different applications and desktops, and manage file and device access.

Manage an account

To access desktops and applications, you need an account with XenDesktop or Citrix Virtual Apps. Your IT help desk might ask you to add an account to Citrix Workspace for this purpose. Or they might ask you to use a different Citrix Gateway or Access Gateway server for an existing account. You can also remove accounts from Citrix Workspace.

  1. On the Accounts page of the Preferences dialog, do one of the following:
    • To add an account, click Add. Contact your system administrator for more information.
    • To change details of a store that the account uses, such as the default gateway, click Edit.
    • To remove an account, click Remove.
  2. Follow the on-screen prompts. When prompted, authenticate to the server.

Desktop display


This feature is not available with Citrix Virtual Apps for UNIX sessions.

You can display desktops across the entire screen on your user device (full screen mode), which is the default, or in a separate window (windowed mode).

  • On the General page of the Preferences dialog box, select a mode using the Display desktop in option.

Use the You can enable Desktop Viewer toolbar functionality to dynamically modify the window configuration of your remote session.

Desktop Viewer

Your requirements for the way users access virtual desktops can vary from user to user and might vary as your corporate needs evolve.

Use the Desktop Viewer when users interact with their virtual desktop. The user’s virtual desktop can be a published virtual desktop, or a shared or dedicated desktop. In this access scenario, the Desktop Viewer toolbar functionality allows the user to switch a session between windowed and full-screen session window, including multi-monitor support for the intersected monitors. Users can switch between desktop sessions and use more than one desktop using multiple Citrix Virtual Apps and Desktops connections on the same user device. Buttons to minimize all desktop sessions, send the Ctrl+Alt+Del sequence, disconnect, and log off from the session are provided to manage a user’s session conveniently.

Pressing Ctrl+Alt+Break displays the Desktop Viewer toolbar buttons in a pop-up window.

Automatic session reconnect

Citrix Workspace app can reconnect to desktops and applications that are disconnected. For example, a network infrastructure issue.

  • On the General page of the Preferences dialog box, select an option in Reconnect apps and desktops.

Access local files

A virtual desktop or application needs access to files on your device. You can control the extent to which this happens.

  1. On the File Access page of the Preferences dialog box, select a mapped drive and then one of the following options:
    • Read and write - Allow the desktop or application to read and write to local files.
    • Read only - Allow the desktop or application to read but not write to local files.
    • No access - Do not allow the desktop or application to access local files.
    • Ask me each time - Display a prompt each time the desktop or application access local files.
  2. Click Add, specify the location, and select a drive to map to it.

Microphone and Webcam

To set up a microphone or a webcam, you can change the way a virtual desktop or application accesses your local microphone or webcam:

On the Mic & Webcam page of the Preferences dialog box, select one of the following options:

  • Use my microphone and webcam - Allow the microphone and webcam to be used by the desktop or application.
  • Don’t use my microphone or webcam - Do not allow the microphone or webcam to be used by the desktop or application.

Flash player

You can choose how flash content is displayed. This content is normally displayed in Flash Player and includes video, animation, and applications:

On the Flash page of the Preferences dialog box, select one of the following options:

  • Optimize content - Improves playback quality at the risk of reducing security.
  • Don’t optimize content - Provides basic playback quality without reducing security.
  • Ask me each time - Prompts each time a flash content is displayed.


Citrix Workspace app provides users with secure, self-service access to virtual desktops and applications, and on-demand access to Windows, web, and Software as a Service (SaaS) applications. Citrix StoreFront or legacy webpages created with Web Interface manage the user access.

To connect to resources using the Citrix Workspace UI

The Citrix Workspace app home page displays virtual desktops and applications that are available to the users based on their account settings (that is, the server they connect to) and settings configured by Citrix Virtual Apps and Desktops administrators. Using the Preferences > Accounts page, you can configure the URL of a StoreFront server or, if email-based account discovery is configured, by entering the email address.


If you use the same name for multiple stores on the StoreFront server, you avoid duplications by adding numbers. The names for such stores depend on the order in which they are added. For Citrix Workspace app, the store URL is displayed and uniquely identifies the store.

After connecting to a store, the self-service shows the tabs: FAVORITES, DESKTOPS, and APPS. To launch a session, click the appropriate icon. To add an icon to FAVORITES, click the Details link next to the icon and select Add To Favorites.

Configure connection settings

You can configure some default settings for connections between Citrix Workspace app and Citrix Virtual Apps and Desktops servers. You can also change these settings for individual connections, if necessary.

Although the tasks and responsibilities of administrators and users can overlap, the term “user” is employed to distinguish typical user tasks from those tasks typically performed by administrators.

Connect to resources from a command line or browser

You create connections to servers when you click a desktop or application icon on the Citrix Workspace app home page. In addition, you can open connections from a command line or from a web browser.

To create a connection to a Program Neighborhood or StoreFront server using a command line


Ensure that the store is known to Citrix Workspace app. If necessary, add it using the following command:

./util/storebrowse --addstore \<store URL\>

  1. Obtain the unique ID of the desktop or application that you want to connect to. This ID is the first quoted string on a line acquired in one of the following commands:

    • List all desktops and applications on the server:

      ./util/storebrowse -E <store URL>

    • List the desktops and applications that you have subscribed to:

      ./util/storebrowse -S <store URL>

  2. Run the following command to start the desktop or application:

    ./util/storebrowse –L <desktop or application ID> <store URL>

If you cannot connect to a server, your administrator might need to change the server location or SOCKS proxy details. For more information, see proxy server.

To create a connection from a web browser

Configuration for starting sessions from a web browser is typically carried out automatically during installation. Because of the wide variety of browsers and operating systems, some manual configuration can be required.

If you set up .mailcap and MIME files for Firefox, Mozilla, or Chrome manually, use the following file modifications so that .ICA files start up the Citrix Workspace app executable, wfica. To use other browsers, modify the browser configuration accordingly.

  1. Run the following commands for non-administrator installation of Citrix Workspace app. The settings of ICAROOT might be changed if they are installed to a non-default location. You can test the result with the command

    xdg-mime query default application/x-ica, which must return “wfica.desktop.”

    setenv ICAROOT=/opt/Citrix/ICAClient

    xdg-icon-resource install --size 64

    $ICAROOT/icons/000\_Receiver_64.png Citrix Workspace app

    xdg-mime default wfica.desktop application/x-ica

    xdg-mime default new\_store.desktop application/vnd.citrix.receiver.configure

  2. Create or extend the file /etc/xdg/mimeapps.list (for administrator installation) or $HOME/.local/share/applications/mimeapps.list (mimeapps.list). The file must start with [Default Applications], and follow by:



    You might need to configure Firefox on its Preferences/Applications setting page.

    For “Citrix ICA settings file content,” select:

    • “Citrix Workspace app Engine (default)” in the drop-down menu


    • “Use other …” and then select the file /usr/share/applications/wfica.desktop (for an administrator installation of Citrix Workspace app)


    • $HOME/.local/share/applications/wfica.desktop (for a non-administrator installation).

Connection Center

Users can manage their active connections using the Connection Center. This feature is a useful productivity tool that enables users and administrators to troubleshoot slow or problematic connections. With Connection Center, users can manage connections by:

  • Closing an application.
  • Logging off a session. This step ends the session and closes any open applications.
  • Disconnecting from a session. This step cuts the selected connection to the server without closing any open applications (unless the server is configured to close applications on disconnection).
  • Viewing connection transport statistics.

Manage a connection

To manage a connection using the Connection Center:

  1. On the Citrix Workspace app menu, click Connection Center.

    The servers that are used appear and active sessions are listed.

  2. Do one of the following:

    • Select a server, disconnect or log off, or view its properties.
    • Select an application, close the window.

Custom web stores

This feature is in the Technical Preview. You can access your organization’s custom web store from the Citrix Workspace app.

To use this feature, the administrator must add the domain or the custom web store to the list of allowed URLs in the Global App Configuration Service. After you have added the domain or the custom web store, provide the custom web store URL in the Add Account screen in the Citrix Workspace app. The custom web store opens in the native Workspace app window.

For more information about configuring web store URLs for end-users, see Global App Configuration Service.

To remove the custom web store, go to Accounts > Add or Remove accounts, select the custom web store URL, and click Remove.

As a prerequisite, you must enable the custom web store in the AuthManConfig.xml file. To enable it:

  1. Navigate to the $ICAROOT/config/AuthManConfig.xml configuration file.
  2. Add the following entries:

  3. If AppConfigEnabled value is disabled, add the following entries, and list the URLs that must be considered for the custom web store.



You can only use the URLs listed in the AuthManConfig.xml file for the custom web store. You can add multiple URLs in theAuthManConfig.xml file that you want to be considered for the custom web store.

Get started