Get started

Set up

After you download the installation package, you can customize the configuration before installation by modifying the contents of the Citrix Workspace app package. You can then repackage the files. Your changes are included in every version installed using the modified package.

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 might add a TLS root certificate to the package if you want to use a certificate from a Certificate Authority that is not part of the standard Citrix Workspace app installation. To add a TLS root certificate to the package, see Install root certificates on user devices on the Citrix Product Documentation site.
  3. Open the PkgID file.
  4. Add the following line to indicate that the package was modified: MODIFIED=traceinfo where traceinfo is information indicating who made the change and when. The exact format of this information is not important.
  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. If you do not update this file, errors can occur when installing your new package. Changes could 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 (which must always be 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.


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

If Citrix Workspace app was not installed in the default installation directory, 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, or where the tarball is used but where 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 for Linux by navigating to it 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 XenDeskop 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 box, do one of the following:
    • To add an account, click Add. Your help desk may alternatively provide a provisioning file with account information that you can use to create an account.
    • 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. You may be required to 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.

Citrix Workspace app now has the You can enable Desktop Viewer toolbar functionality so it is possible dynamically modify the window configuration of your remote session from the original settings specified by the configuration mentioned here.

Desktop Viewer

Different enterprises have different corporate needs. Your requirements for the way users access virtual desktops may vary from user to user and may vary as your corporate needs evolve. The user experience of connecting to virtual desktops and the extent of user involvement in configuring the connections depend on how you set up Citrix Workspace app.

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 work with 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 the session are provided to manage a user’s session conveniently.

As an accessibility feature of the Desktop Viewer, pressing Ctrl+Alt+Break displays the Desktop Viewer toolbar buttons in a pop-up window.

See the Linux OEM guide for advanced configuration entries to enable or disable Desktop Viewer or change the accessibility key sequence.

Automatic session reconnect

Citrix Workspace app can reconnect to desktops and applications that you become disconnected from (for example, if there is 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 may need to access 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 needs to access local files.
  2. If you selected one of the options that grants access to local files, you can additionally save time when browsing to locations on your user device. 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, users can perform that configuration themselves by entering the URL of a StoreFront server or, if email-based account discovery is configured, by entering their 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 PNAgent, the store URL is displayed and uniquely identifies the store.

After connecting to a store, 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 those 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 typically performed by administrators.

Connect to resources from a command line or browser

You create connections to servers when you click on 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 is the first quoted string on a line acquired in one of the following commands:

    • List all of the 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 pull-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 Connection Center:

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

    The servers that are used are shown and, for each server, the active sessions are listed.

  2. Do one of the following:

    • Select a server, and disconnect from it, log off from it, or view properties of it.
    • Select an application, and close the window it is displayed in.

Get started