WorkSpaces Linux client application

The following information will help you get started with the WorkSpaces Linux client application.

Requirements

The WorkSpaces Linux client application requires either 64-bit Ubuntu 18.04 or 20.04 (AMD64). IGEL OS is supported by the WorkSpaces Linux client.

Note

• By default, Linux client access is disabled. To use this client with your WorkSpace, your Amazon WorkSpaces administrator must enable Linux client access for your WorkSpaces directory. For more information, see Control Device Access in the Amazon WorkSpaces Administration Guide.

• The WorkSpaces Linux client application is not available for the WorkSpaces Streaming Protocol (WSP).

• If your WorkSpace is located in the Asia Pacific (Mumbai) Region, you must use version 3.1.3 or later of the Amazon WorkSpaces Linux client application.

• You can connect to Ubuntu WorkSpaces using the Windows and macOS client applications, and Web Access. Linux client support is currently not available.

Setup and installation

Download and install the WorkSpaces Linux client application from Amazon WorkSpaces Client Downloads. Detailed installation instructions are included on the Linux client page on the Client Downloads site.

To launch the Linux client from the command line, use:

/opt/workspacesclient/workspacesclient

Connecting to your WorkSpace

To connect to your WorkSpace, complete the following procedure.

To connect to your WorkSpace

1. The first time that you run the client application, you are prompted for your registration code, which is contained in your welcome email. The WorkSpaces client application uses the registration code and user name to identify which WorkSpace to connect to. When you launch the client application later, the same registration code is used. To enter a different registration code, launch the client application, and then choose Change Registration Code at the bottom of the login page.

2. Enter your sign-in credentials in the login screen and choose Sign In. If your WorkSpaces administrator has enabled multi-factor authentication for your organization's WorkSpaces, you are prompted for a passcode to complete your login. Your WorkSpaces administrator will provide more information about how to obtain your passcode.

3. If your WorkSpaces administrator has not disabled the Keep me logged in feature, you can select the Keep me logged in check box at the bottom of the login screen to save your credentials securely so that you can connect to your WorkSpace easily while the client application remains running. Your credentials are securely cached up to the maximum lifetime of your Kerberos ticket.

   After the client application connects to your WorkSpace, your WorkSpace desktop is displayed.

An interruption of network connectivity causes an active session to be disconnected. This can be caused by events such as closing the laptop lid, or the loss of your wireless network connection. The WorkSpaces client application for Linux attempts to reconnect the session automatically if network connectivity is regained within a certain amount of time. The default session resume timeout is 20 minutes, but this timeout can be modified by your network administrator.

Manage your login information (3.0+ clients only)

You can view your registration code and what Region your WorkSpace is in. You can specify whether you want the WorkSpaces client application to save your current registration code, and you can assign a name to your WorkSpace. You can also specify if you want Amazon WorkSpaces to keep you logged in to a WorkSpace until you quit or your login period expires.

To manage your login information for a WorkSpace

1. In the WorkSpaces client application, go to Settings, Manage Login Information.

2. In the Manage Login Information dialog box, you can see the registration code and Region information for your WorkSpace.

3. (Optional) If you want the WorkSpaces client to remember your current registration code, select the Remember Registration Code check box.

4. Under Saved registration codes, select the WorkSpace you want to name.

5. In the WorkSpace name box, enter a name for the WorkSpace.

6. (Optional) If you want WorkSpaces to keep you logged in until you quit or your login period expires, select the Keep me logged in check box.

7. Choose Save.

Client views

You can switch to full screen mode by choosing View, Enter Full Screen in the client application menu.

While in full screen mode, you can switch back to window mode by moving the pointer to the top of the screen. The client application menu is displayed, and you can choose View, Leave Full Screen in the client application menu.

You can also toggle full screen mode by pressing Ctrl+Alt+Enter.

Client language

You can select the language displayed by the client by performing the following steps.

Note

In the client, Japanese is available in all Regions. However, Japanese is only available in Tokyo for individual WorkSpaces.

To select the client language

1. In the WorkSpaces client application, go to Settings, Change Language.

2. Enter your desired language in the Select a language list and choose Save.

3. Restart the client.

Display support

WorkSpaces Value, Standard, Performance, Power, PowerPro, and GraphicsPro bundles support a maximum of four displays and a maximum resolution of 3840x2160 (ultra-high definition, or UHD). The maximum supported resolution depends on the number of displays, as shown in the following table.

Displays	Resolution
2	3840x2160
4	1920x1200

Note

Graphics bundles support only a single monitor configuration with a maximum resolution of 2560x1600.

The WorkSpaces client application extracts the Extended Display Information Data (EDID) of all attached displays and determines the best compatibility match before starting the session. If you have a high pixel density (high DPI) display, the client application automatically scales the streaming window according to your local DPI settings. For better maximum resolution with high DPI displays, see WorkSpaces high DPI display support.

To use multiple monitors with WorkSpaces

1. Configure your local machine to use multiple monitors.

2. Start the WorkSpaces client application and log in to your WorkSpace.

3. Depending on which client you're using, do one of the following:

   If you're using...	Do this
   3.0+ client	Choose View, Enter Full Screen On All Displays. You can also toggle full screen mode by pressing Ctrl+Alt+Enter.
   2.0+ client	Choose View, Show Fullscreen. You can also toggle full screen mode by pressing Ctrl+Alt+Enter.

Your WorkSpace should now be extended across your displays. Whichever display you have designated as your primary display is also the primary display in WorkSpaces when you enter full screen mode.

Note

Using full screen mode on only some of the displays in a multiple monitor setup isn't possible. You can, however, press Alt+F10 or double-click the title bar to maximize the WorkSpaces client window on a display without extending the WorkSpace to the other displays.

Proxy servers

If your network requires you to use a proxy server to access the internet, you can enable your WorkSpaces client application to use a proxy for HTTPS (port 443) traffic. The WorkSpaces client applications use the HTTPS port for updates, registration, and authentication.

Note

• The desktop streaming connections to the WorkSpace require ports 4172 and 4195 to be enabled, and do not go through the proxy server.

• Proxy servers that require authentication with a sign-in credentials are not supported.

To use a proxy server

By default, the Linux client uses the proxy server that's specified in the device operating system settings. The first time the client is launched, the device operating system proxy server setting is used. If you select another option for the proxy server, that setting is used for subsequent launches of the client.

Note

In versions 3.0.0 through 3.1.4, if you specify a custom proxy server, a "No network" error might appear when you attempt to log in to your WorkSpace. If you want to use a custom proxy server with the Linux client, we recommend upgrading to version 3.1.5. If you can't upgrade, you can work around the issue by using the default operating system proxy server instead of specifying a custom proxy server in the Linux client.

1. In the WorkSpaces client application, go to Settings, Manage Proxy Server.

2. In the Set Proxy dialog box, select Use proxy server, enter the proxy server URL or IP address and the port, and choose Save.

Command shortcuts

The WorkSpaces Linux client supports the following command shortcuts:

• Ctrl+Alt+Enter—Toggle full screen display

Clipboard redirection

Clipboard supports a maximum uncompressed object size of 20 MB. For more information, see I'm having trouble copying and pasting.

Disconnect

To disconnect the Linux client application, you have several options:

• In the Amazon WorkSpaces client application, go to Amazon WorkSpaces, and then choose Disconnect WorkSpace. Your WorkSpace session ends, but the client application continues running in case you want to log in again.

• In the Amazon WorkSpaces client application, go to Amazon WorkSpaces, and then choose Quit Amazon WorkSpaces. Your WorkSpace session ends, and the client application closes.

• In the Amazon WorkSpaces client application, close the WorkSpaces client window by clicking the close (X) button in the upper-right corner. In the End Session dialog box, choose Yes. Your WorkSpace session ends, but the client application continues running in case you want to log in again.

Release notes

Linux 20.04 client application release notes

The following table describes the changes to each release of the Linux 20.04 client application.

Release	Date	Changes
4.5.0	December 27, 2022	Resolved the issue of users being unable to disconnect from WorkSpaces when their network connectivity was lost or unavailable. Updated PCoIP SDK for the WorkSpaces Linux client.
4.4.0	October 27, 2022	Ubuntu Linux 20.04 support.

Linux 18.04 client application release notes

The following table describes the changes to each release of the Linux 18.04 client application.

Release	Date	Changes
4.4.0	December 27, 2022	Resolved the issue of users being unable to disconnect from WorkSpaces when their network connectivity was lost or unavailable. Updated PCoIP SDK for the WorkSpaces Linux client.
4.3.0	October 5, 2022	Updated PCoIP SDK for Linux.
4.2.0	August 24, 2022	Fixed changing monitor's relative positions issue on WorkSpaces. Minor bug fixes and enhancements.
4.1.0	April 14, 2022	Enabled clipboard redirection on Linux WorkSpaces.
4.0.1	August 12, 2021	Minor bug fixes and enhancements.
3.1.9	July 1, 2021	Minor bug fixes and enhancements.
3.1.8	June 3, 2021	Fixes an audio output issue Minor bug fixes and enhancements
3.1.7	May 6, 2021	Minor bug fixes and enhancements
3.1.5	April 2, 2021	Minor bug fixes and enhancements
3.1.4	March 16, 2021	Addresses a few crash scenarios when users register, log in, and rebuild Adds localization support for more UI elements Minor bug fixes and enhancements
3.1.3	February 15, 2021	Improves Alt key mapping Minor bug fixes and enhancements
3.1.2	January 8, 2021	Minor bug fixes and enhancements
3.1.0	December 1, 2020	Minor bug fixes and enhancements
3.0.12	November 10, 2020	Adds enhancements to the session reconnect experience
3.0.11	October 02, 2020	Resolves an issue with persisting a user's screen size preference when the user chooses full screen mode and then exits this mode Resolves an issue with the backslash and underscore keys not being recognized inside the WorkSpace on Japanese language keyboards Minor bug fixes and enhancements
3.0.10	September 16, 2020	Minor bug fixes and enhancements
3.0.9	August 14, 2020	Minor bug fixes and enhancements
3.0.8	July 30, 2020	For improved diagnostics, displays round trip time (RTT) as part of the network health check information Minor bug fixes and enhancements
3.0.7	June 3, 2020	Minor bug fixes and enhancements
3.0.6	April 29, 2020	Adds support for toggling between high DPI and standard DPI displays Resolves an issue with the user interface displaying a login prompt if single sign-on (SSO) is enabled for Amazon WorkDocs Resolves an issue where the Windows logo key did not map correctly into the WorkSpace Minor bug fixes and enhancements
3.0.4	March 3, 2020	Minor bug fixes and enhancements
3.0.1	December 19, 2019	Bug fixes and UI enhancements
3.0.0	November 25, 2019	Initial release of Linux client Ubuntu Linux 18.04 support Friendly registration code labels