# WorkSpaces clients
<a name="amazon-workspaces-clients"></a>

You can connect to your WorkSpace using the client application for a supported device or a web browser. To start using your WorkSpace, see [Getting started with your WorkSpace](workspaces-user-getting-started.md).

**Important**  
WorkSpaces Pool is supported only on the macOS, Web Access, and Windows client Application version 5.20.0 or greater.

**Topics**
+ [WorkSpaces Android client application](amazon-workspaces-android-client.md)
+ [WorkSpaces iPad client application](amazon-workspaces-ipad-client.md)
+ [WorkSpaces Linux client application](amazon-workspaces-linux-client.md)
+ [WorkSpaces macOS client application](amazon-workspaces-osx-client.md)
+ [WorkSpaces PCoIP zero client](amazon-workspaces-pcoip-zero-client.md)
+ [WorkSpaces Web Access](amazon-workspaces-web-access.md)
+ [WorkSpaces Windows client application](amazon-workspaces-windows-client.md)

# WorkSpaces Android client application
<a name="amazon-workspaces-android-client"></a>

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

**Topics**
+ [Requirements](#android-requirements)
+ [Setup and installation](#android_setup)
+ [Connect to your WorkSpace](#android_connecting)
+ [Gestures](#android_gestures)
+ [Sidebar menu](#android_sidebar_menu)
+ [Keyboard](#android_keyboard)
+ [Trackpad mode](#android_trackpad_mode)
+ [Display support](#android_display_support)
+ [Disconnect](#android_disconnect)
+ [Clipboard support](#android_clipboard_support)
+ [Release notes](#android-release-notes)

## Requirements
<a name="android-requirements"></a>

The Amazon WorkSpaces Android client application requires the following:
+ Amazon Kindle Fire tablets released after 2012 with Fire OS 4.0 and later.
+ Android tablets and phones with Android OS 4.4 and later. The client application works on most devices with Android version 4.4 or later, but some devices might not be compatible.
**Note**  
Versions of the Android client application after 2.4.15 require devices with Android OS 9 and later.  
Versions of the Android client application after 5.0.0 require devices with Android OS 13 and later.
+ Chromebooks that support installing Android applications. Chromebooks launched in 2019 or later support installing Android applications. However, some Chromebooks launched before 2019 might not support installing Android applications.

  We recommend using the Android client application if your Chromebook supports it. To determine whether your Chromebook is compatible with the Amazon WorkSpaces Android client application or whether it requires the Amazon WorkSpaces Chromebook client application, see the [installation steps for Chromebooks launched before 2019](#chromebook_install_before_2019).
+ Devices that support running 64-bit applications.

**Note**  
The WorkSpaces Android client application is not available for the DCV.
If your WorkSpace is located in the Asia Pacific (Mumbai) Region, you must use version 2.4.19 or later of the Amazon WorkSpaces Android client application.

## Setup and installation
<a name="android_setup"></a>

To download and install the client application, complete the following procedure.

**(For devices other than Chromebooks launched before 2019)To download and install the client application**

1. On your device, open [https://clients.amazonworkspaces.com/](https://clients.amazonworkspaces.com/) and choose the link for your device (either **Android/Chromebook** or **Fire Tablet**).

1. Download and install the application.

1. Verify that the Amazon WorkSpaces client application icon appears on one of the device desktops.

**(For Chromebooks launched before 2019) To download and install the client application**

1. Determine whether your Chromebook supports Android applications by checking its status on the list of [ Chrome OS Systems Supporting Android Apps](https://sites.google.com/a/chromium.org/dev/chromium-os/chrome-os-systems-supporting-android-apps).

1. Depending on your Chromebook's status, do one of the following:
   + If your Chromebook's status is marked as **Stable Channel**, do the following:

     1. Follow the instructions in [ Install Android apps on your Chromebook](https://support.google.com/chromebook/answer/7021273) to enable your Chromebook to install Android applications. 
**Note**  
In some cases, your WorkSpaces administrator might need to enable your Chromebook to install Android applications. If you are unable to install the Android client application on your Chromebook, contact your WorkSpaces administrator for assistance.

     1. On your Chromebook, open [https://clients.amazonworkspaces.com/](https://clients.amazonworkspaces.com/) and choose **Android/Chromebook**.

     1. Download and install the application.

     1. Verify that the Amazon WorkSpaces client application icon appears on one of the device desktops.
   + If your Chromebook's status is marked as **Planned** or if your Chromebook does not appear on the list, do the following:

     1. Determine whether your Chromebook meets the requirements of the Amazon WorkSpaces Chromebook client application:
        + The WorkSpaces Chromebook client application requires a Chromebook with Chrome OS version 45 or later. The client application works on most Chromebooks with version 45 or later, but some devices might not be compatible. If you have problems with a device, you can report the problem on the [WorkSpaces forum](https://forums.aws.amazon.com/forum.jspa?forumID=164).
        + To check the version of Chrome OS on your Chromebook, go to the status area, where your account picture appears. Choose **Settings**, **About Chrome OS**.

     1. If your Chromebook is running Chrome OS version 45 or later, open the link to the [ Amazon WorkSpaces Chromebook client application](https://chromewebstore.google.com/detail/amazon-workspaces/ipaonomeflaallpcgnhcaoonfghaojha) on the Chrome Web Store.

     1. Download and install the application.

     1. Verify that the Amazon WorkSpaces client application icon appears in your Chromebook search.

## Connect to your WorkSpace
<a name="android_connecting"></a>

To connect to your WorkSpace, complete the following procedure.

**To connect to your WorkSpace**

1. On your device, open the Amazon WorkSpaces client application.

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. You can enter a different registration code by launching the client application and tapping **Enter new registration code** on the login screen.

1. Enter your sign-in credentials and tap **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.

1. If your WorkSpaces administrator has not disabled the "Remember Me" feature, you are prompted to save your credentials securely so that you can connect to your WorkSpace easily in the future. Your credentials will be securely cached up to the maximum lifetime of your Kerberos ticket.

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

## Gestures
<a name="android_gestures"></a>

The following gestures are supported for the WorkSpaces Android client application.

Single tap  
Equivalent to a single click in Windows.

Double tap  
Equivalent to a double-click in Windows.

Two finger single tap  
Equivalent to a right-click in Windows.

Two finger double tap  
Toggles the on-screen keyboard display. If a keyboard is attached to the device, a set of keyboard shortcuts is shown instead.

Swipe from left  
Displays the sidebar menu. For more information, see [Sidebar menu](#android_sidebar_menu).

Two finger scroll  
Scrolls vertically.

Two finger pinch  
Zooms display in or out.

Two finger pan  
Pans the desktop when zoomed in.

## Sidebar menu
<a name="android_sidebar_menu"></a>

The sidebar menu is displayed by swiping from the left side of the screen.

![\[Android sidebar menu\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/android-sidebar-menu.png)


The sidebar menu provides quick access to the following features:

![\[Android sidebar trackpad\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/android-sidebar-trackpad.png) **Trackpad Mode** – Turns the trackpad on or off. For more information, see [Trackpad mode](#android_trackpad_mode). 

![\[Android sidebar keyboard\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/android-sidebar-keyboard.png) **Show Keyboard** – Toggles the display of the on-screen keyboard. If a keyboard is already attached, only a row of keyboard shortcuts is displayed. 

![\[Android sidebar settings\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/android-sidebar-settings.png) **Settings** – Displays controls to change the screen resolution or the scroll direction. 

![\[Android sidebar connection\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/android-sidebar-connection.png) **Connection Check** – Displays the connection status.

![\[Android sidebar Windows menu\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/android-sidebar-windows.png) **Windows Menu** – Displays the Windows Start Menu. 

![\[Android sidebar disconnect\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/android-sidebar-disconnect.png) **Disconnect** – Disconnects the client application without logging off.

## Keyboard
<a name="android_keyboard"></a>

To toggle the display of the on-screen keyboard, double-tap with two fingers anywhere on the screen. Special key combinations are displayed in the top row of the keyboard.

## Trackpad mode
<a name="android_trackpad_mode"></a>

The trackpad mode is set using the [sidebar menu](#android_sidebar_menu).

### Trackpad mode off
<a name="android_trackpad_off"></a>

When trackpad mode is off, the mouse cursor is placed wherever you tap your finger. In this mode, a single tap is equivalent to a left mouse button click and a two finger single tap is equivalent to a right mouse button click.

### Trackpad mode on
<a name="android_trackpad_on"></a>

When trackpad mode is on, the mouse cursor tracks the movement of your finger on the screen. In this mode, simulate a left mouse button click by tapping the left mouse button icon.

![\[Left mouse button icon\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/mouse-icon-left.png)


Simulate a right mouse button click by tapping the right mouse button icon.

![\[Right mouse button icon\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/mouse-icon-right.png)


## Display support
<a name="android_display_support"></a>

The Amazon WorkSpaces Android client application supports a single monitor. Multiple monitors are not supported.

The maximum supported screen resolution depends on your device's display. Although specific screen resolution settings are offered in the **Settings** menu, if you choose **Default**, WorkSpaces matches the resolution that you've set on your device. If your device supports a resolution higher than 2800x1752, choose **Default** if you want WorkSpaces to use a higher resolution. 


| Resolution setting | When to use | 
| --- | --- | 
| 2800x1752, 2560x1440, 1920x1080, 1600x900, 1280x720, 960x540 | Choose one of these settings if you want your display to use this exact resolution. | 
| Default | Choose this setting to match the resolution that you've set on your device, up to the maximum resolution that your device supports. If you choose Default and you're using a high DPI display, the screen resolution is adjusted to a lower one so that text and icons are easier to read.  | 
| High DPI Mode | Choose this setting for better maximum resolution of your WorkSpace on high DPI displays. If you choose High DPI Mode and the text and icons on your WorkSpace are smaller than you'd prefer, either choose Default instead, or adjust the scaling settings on your WorkSpace. For more information about high DPI mode and how to adjust the scaling settings on your WorkSpace, see [Enabling high DPI display for WorkSpaces](high_dpi_support.md). | 

## Disconnect
<a name="android_disconnect"></a>

To disconnect the Android client, display the sidebar menu, tap the disconnect icon, and tap **Disconnect**. You can also log off of the WorkSpace, which disconnects the client.

## Clipboard support
<a name="android_clipboard_support"></a>

The clipboard supports copy and paste of text and HTML content only. The maximum uncompressed object size is 20 MB. For more information, see [I'm having trouble copying and pasting](client_troubleshooting.md#copy_paste).

**Note**  
When copying from a Microsoft Office app, the clipboard only contains the last copied item, and the item is converted into standard format. If you copy content larger than 890 KB from a Microsoft Office app, the app might become slow or unresponsive for up to 5 seconds. 

## Release notes
<a name="android-release-notes"></a>

### Android client application release notes
<a name="android-client-release-notes"></a>

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


| Release | Date | Changes | 
| --- | --- | --- | 
|  5.1.1  | April 2, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  5.0.1  | November 6, 2024 |  Bug fixes and enhancements.  | 
|  5.0.0  | February 26, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  4.0.6  | August 18, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  4.0.5  | May 5, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  4.0.4  | December 15, 2022 |  Updated the .NET framework for the WorkSpaces Android client  | 
|  4.0.3  | October 20, 2022 |  Upgraded target Android API level to continue supporting 64-bit Android 12 and later versions  | 
|  4.0.2  | August 3, 2022 |  Resolved an issue that the touchpad scrolling was too sensitive within WorkSpaces on Chromebooks  | 
|  4.0.1  | May 12, 2022 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  3.0.4  | October 14, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
| 3.0.2 | July 13, 2021 |  Minor enhancements and fixes  | 
| 3.0.1 | June 30, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
| 2.4.21 | May 20, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  Because the 32-bit PCoIP SDK for Android has reached the end of support, Version 2.4.21 is the final release of Amazon WorkSpaces Android client, which supports both 32-bit and 64-bit for Android 9 and above. Next release onwards, Amazon WorkSpaces Android client will only support 64-bit.   | 
|  2.4.20  | March 25, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.19  | February 22, 2021 |  Enhanced support for resolution 2560x1440  | 
|  2.4.18  | October 19, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.17  | February 24, 2020 |  Minor enhancements and fixes  | 
|  2.4.16  | January 30, 2020 |  Added support for versions above 64-bit Android 9  | 
|  2.4.15  | June 24, 2019 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.14  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.13  |  |  Minor fixes  | 
|  2.4.12  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.11  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.10  |  |  Improves support for Japanese keyboard layouts  | 
|  2.4.9  |  |  Adds support for Samsung Galaxy Note 9  | 
|  2.4.7  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.6  |  |  Adds support for uniform resource identifiers (URIs), which enable login orchestration  | 
|  2.4.5  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.4  |  | Minor improvements to session provision handling | 
|  2.4.2  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.3.4  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.3.3  |  |  Localization enhancements  | 
|  2.2.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.1.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.0.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  1.0.15  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  1.0.11  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  1.0.10  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  1.0.9  |  |  Improves the login experience  | 
|  1.0  |  |  Initial release  | 

### Chromebook client application release notes
<a name="android-chromebook-release-notes"></a>

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

**Note**  
Version 2.4.13 is the final release of the Amazon WorkSpaces Chromebook client application. Because [ Google is phasing out support for Chrome Apps](https://blog.chromium.org/2020/01/moving-forward-from-chrome-apps.html), there will be no further updates to the WorkSpaces Chromebook client application, and its use is unsupported.


| Release | Date | Changes | 
| --- | --- | --- | 
|  2.4.13  | April 24, 2019 |  Fixed an issue that causes the app not to restore to full-screen mode after a screen unlock  | 
|  2.4.12  |  |  Minor bug fixes  | 
|  2.4.11  |  |  Minor bug fixes  | 
|  2.4.10  |  |  Improves support for Japanese keyboard layouts  | 
|  2.4.8  |  |  Improves support for UK keyboards  | 
|  2.4.7  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.6  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.5  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.4.4  |  |  Minor improvements to session provision handling  | 
|  2.4.2  |  |  Resolves a bug with Caps Lock  | 
|  2.4.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.2.7  |  |  Resolves minor issues  | 
|  2.2.4  |  |  Localization enhancements  | 
|  2.2.1  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.1.3  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  2.0.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-android-client.html)  | 
|  1.0  |  |  Initial release  | 

# WorkSpaces iPad client application
<a name="amazon-workspaces-ipad-client"></a>

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

**Topics**
+ [Requirements](#ipad-requirements)
+ [Setup and installation](#ipad_setup)
+ [Connect to your WorkSpace](#ipad_connecting)
+ [Gestures](#ipad_gestures)
+ [Radial menu](#ipad_radial_menu)
+ [Keyboard and command shortcuts](#ipad_keyboard)
+ [Mouse modes](#ipad_mouse_modes)
+ [Swiftpoint GT, ProPoint, or PadPoint mouse](#ipad_gt_mouse)
+ [Disconnect](#ipad_disconnect)
+ [Clipboard support](#ipad_clipboard_support)
+ [Release notes](#ipad-release-notes)

## Requirements
<a name="ipad-requirements"></a>

The WorkSpaces iPad client application requires the following:
+ iPad 2 or later with iOS 8.0 to 17.0
+ iPad Retina with iOS 8.0 to 17.0
+ iPad Mini with iOS 8.0 to 17.0
+ iPad Pro with iOS 9.0 to 17.0

**Note**  
The Amazon WorkSpaces iPad client application is not available for the DCV.
If your WorkSpace is located in the Asia Pacific (Mumbai) Region, you must use version 2.4.17 or later of the Amazon WorkSpaces iPad client application.
If your iPad is using iPadOS 14.5 to 17.0, we recommend using version 2.4.18 or later of the Amazon WorkSpaces iPad client application.

## Setup and installation
<a name="ipad_setup"></a>

To download and install the client application, complete the following procedure.

**To download and install the client application**

1. On your iPad, open [Amazon WorkSpaces Client Downloads](https://clients.amazonworkspaces.com/) and choose the **iPad** link.

1. Download and install the application.

1. Verify that the Amazon WorkSpaces client application icon appears on one of the iPad desktops.

## Connect to your WorkSpace
<a name="ipad_connecting"></a>

To connect to your WorkSpace, complete the following procedure.

**To connect to your WorkSpace**

1. On your iPad, open the Amazon WorkSpaces client application.

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. You can enter a different registration code by launching the client application and choosing **Enter new registration code** on the login screen.

1. Enter your sign-in credentials 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.

1. If your WorkSpaces administrator has not disabled the "Remember Me" feature, you are prompted to save your credentials securely so that you can connect to your WorkSpace easily in the future. Your credentials will be securely cached up to the maximum lifetime of your Kerberos ticket.

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

## Gestures
<a name="ipad_gestures"></a>

The following gestures are supported for the WorkSpaces iPad client application.

Single tap  
Equivalent to a single click in Windows.

Double tap  
Equivalent to a double click in Windows.

Two finger single tap  
Equivalent to a right-click in Windows.

Two finger double tap  
Toggles the on-screen keyboard display.

Swipe from left  
Displays the radial menu. For more information, see [Radial menu](#ipad_radial_menu).

Two finger scroll  
Scrolls vertically.

Two finger pinch  
Zooms display in or out.

Two finger pan  
Pans the desktop when zoomed in.

## Radial menu
<a name="ipad_radial_menu"></a>

The radial menu is displayed by swiping from the left side of the screen. 

![\[iPad radial menu with the buttons for settings, connection status, disconnect/connect, direct mouse mode, help, keyboard, Windows start menu, and offset mouse mode.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial.png)


The radial menu provides quick access to the following features:

![\[iPad radial menu button for settings.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial-settings.png) **Settings** – Displays controls to change the screen resolution, change the scroll direction, or connect or disconnect the [Swiftpoint GT, ProPoint, or PadPoint mouse](#ipad_gt_mouse).

![\[iPad radial menu button for connection status.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial-connection-status.png) **Connection Status** – Displays the connection status of the WorkSpace. 

![\[iPad radial menu button for radial power.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial-power.png) **Disconnect** – Disconnects the client application without logging off. 

![\[iPad radial menu button for direct mouse mode.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial-direct-mouse.png) **Direct Mouse Mode** – Sets the input to direct mouse mode. For more information, see [Mouse modes](#ipad_mouse_modes). 

![\[iPad radial menu button for help.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial-help.png) **Help** – Displays the command and gesture tutorial. 

![\[iPad radial menu button for keyboard.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial-keyboard.png) **Keyboard** – Toggles the display of the on-screen keyboard. 

![\[iPad radial menu button for Windows start menu.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial-windows.png) **Windows Start Menu** – Displays the Windows Start Menu. 

![\[iPad radial menu button for mouse mode.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/ipad-radial-offset-mouse.png) **Offset Mouse Mode** – Sets the input to offset mouse mode. For more information, see [Mouse modes](#ipad_mouse_modes). 

## Keyboard and command shortcuts
<a name="ipad_keyboard"></a>

To toggle the display of the on-screen keyboard, double-tap with two fingers anywhere on the screen. Special key combinations (command shortcuts) that are frequently used in Windows, such as Ctrl\$1Alt\$1Del, Alt\$1Tab, Ctrl\$1A, Ctrl\$1C, Ctrl\$1V, Ctrl\$1X, and so on, are displayed in the top row of the on-screen keyboard.

If you have a full-size physical keyboard attached to your iPad, you can use Control\$1Option\$1Delete ![\[Forward delete key on iPad keyboard\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/mac-forward-delete.png) to send Ctrl\$1Alt\$1Del to your Windows WorkSpace. (Be sure to use the forward Delete key, not the backspace Delete key.)

## Mouse modes
<a name="ipad_mouse_modes"></a>

The mouse mode is set using the [radial menu](#ipad_radial_menu).

### Direct mode
<a name="ipad_mouse_mode_direct"></a>

In direct mouse mode, the mouse cursor is placed wherever you tap your finger. In this mode, a single tap is equivalent to a left mouse button click and a two finger single tap is equivalent to a right mouse button click.

### Offset mode
<a name="ipad_mouse_mode_offset"></a>

In offset mouse mode, the mouse cursor tracks the movement of your finger on the screen. In this mode, simulate a left mouse button click by tapping the left mouse button icon.

![\[Left mouse button icon\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/mouse-icon-left.png)


Simulate a right mouse button click by tapping the right mouse button icon.

![\[Right mouse button icon\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/mouse-icon-right.png)


## Swiftpoint GT, ProPoint, or PadPoint mouse
<a name="ipad_gt_mouse"></a>

You can use the Swiftpoint GT, ProPoint, or PadPoint mouse on an iPad to interact with your WorkSpace. To do so, before you launch the Amazon WorkSpaces iPad client application, enable Bluetooth on your iPad and pair the Swiftpoint mouse with your iPad (the Swiftpoint mouse should pair automatically). To connect the Swiftpoint mouse and your iPad client, display the radial menu, and tap **Settings**. For **SwiftPoint GT Mouse**, choose **Connect**.

**Note**  
Although the Swiftpoint GT mouse is no longer available, you can use the Swiftpoint ProPoint and PadPoint mice with the Amazon WorkSpaces iPad client application instead. The Swiftpoint TRACPOINT, PenPoint, and GoPoint mice aren't supported for use with the WorkSpaces iPad client. For more information, see [Swiftpoint GT Mouse](https://www.swiftpoint.com/products/ergonomic-mice-propoint).

iPads with iPadOS 13.4 or later also support Bluetooth mice. For more information, see [Use a Bluetooth mouse or trackpad with your iPad](https://support.apple.com/en-us/105004) in the Apple Support documentation.

## Disconnect
<a name="ipad_disconnect"></a>

To disconnect the iPad client application, display the radial menu, tap the disconnect icon, and tap **Disconnect**. You can also log off of the WorkSpace, which disconnects the client.

**To quit the WorkSpaces iPad client application**

1. Open the App Switcher by doing one of the following:
   + Swipe up from the bottom edge and pause in the center of the screen.
   + Double-click the **Home** button (on an iPad with a **Home** button).

1. Swipe up on the WorkSpaces iPad client application to close it.

## Clipboard support
<a name="ipad_clipboard_support"></a>

The clipboard supports copy and paste of text and HTML content only. The maximum uncompressed object size is 20 MB. For more information, see [I'm having trouble copying and pasting](client_troubleshooting.md#copy_paste).

**Note**  
When copying from a Microsoft Office app, the clipboard only contains the last copied item, and the item is converted into standard format. If you copy content larger than 890 KB from a Microsoft Office app, the app might become slow or unresponsive for up to 5 seconds. 

## Release notes
<a name="ipad-release-notes"></a>

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


| Release | Date | Changes | 
| --- | --- | --- | 
| 2.4.28 | August 7, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
| 2.4.27 | February 12, 2025 | Bug fixes and enhancements. | 
| 2.4.26 | November 13, 2024 | Bug fixes and enhancements. | 
|  2.4.25  | October 7, 2023 | Improved client custom branding by storing assets in the same AWS Regions as provisioned WorkSpaces.  | 
|  2.4.24  | May 9, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
| 2.4.21 | August 3, 2022 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
| 2.4.20 | April 30, 2022 | Fixed screen refresh issue that occurred when changing display resolution during active sessions.  | 
|  2.4.19  | Oct 20, 2021 |  Resolves the issue of users not being able to close the on-screen keyboard in iPadOS 15.  | 
|  2.4.18  | May 9, 2021 |  Addresses the crash on startup issue on iPadOS 14.5  | 
|  2.4.17  | February 18, 2021 |  Improved Japanese keyboard support  | 
|  2.4.16  | September 27, 2020 |  Minor bug fixes and enhancements  | 
|  2.4.15  | June 28, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.4.14  | April 17, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.4.13  | February 28, 2020 |  Minor bug fixes  | 
|  2.4.11  | October 28, 2019 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.4.9  |  |  Minor bug fixes  | 
|  2.4.7  |  |  Closing the WorkSpaces client app now expires the reconnect token. You can only reconnect to your WorkSpace when the client app is running.   | 
|  2.4.6  |  |  Minor fixes to the on-screen keyboard  | 
|  2.4.5  |  |  Adds support for uniform resource identifiers (URIs), which enable login orchestration  | 
|  2.4.4  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.4.3  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.4.2  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.4.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.2.4  |  |  Localization enhancements  | 
|  2.2.3  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.2.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.1.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  2.0.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  1.1  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  1.0.11  |  |  Improves stability on iOS 8  | 
|  1.0.10  |  |  Improves stability  | 
|  1.0.9  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  1.0.8  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  1.0.7  |  |  Improves the login experience  | 
|  1.0.6  |  |  Improves the login experience  | 
|  1.0.5  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  1.0.4  |  |  Improves the login experience  | 
|  1.0.3  |  |  Improves the login experience  | 
|  1.0.2  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-ipad-client.html)  | 
|  1.01  |  |  Improves radial functionality  | 
|  1.0  |  |  Initial release  | 

# WorkSpaces Linux client application
<a name="amazon-workspaces-linux-client"></a>

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

**Topics**
+ [Requirements](#linux-requirements)
+ [Setup and installation](#linux_setup)
+ [Connecting to your WorkSpace](#linux_connecting)
+ [Manage your login information](#manage-login-info-linx)
+ [Client views](#linux_views)
+ [Client language](#linux_client_lang)
+ [Display support](#linux-display-support)
+ [Proxy servers](#linux_proxy_server)
+ [Command shortcuts](#linux_shortcuts)
+ [Clipboard redirection](#linux_clipboard)
+ [Disconnect](#linux_disconnect)
+ [Release notes](#linux-release-notes)

## Requirements
<a name="linux-requirements"></a>

For the WorkSpaces Linux client version 2023.x to be able to access the WorkSpaces service, you must add the WorkSpaces Web Access domain (https://webclient.amazonworkspaces.com/) to the allowlist on the network from which the client is trying to access the service. 

**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](https://docs.aws.amazon.com/workspaces/latest/adminguide/update-directory-details.html#control-device-access) in the *Amazon WorkSpaces Administration Guide*.
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.
The WorkSpaces Linux client version 2023.0.4395 for Ubuntu 22.04 is only available for the DCV.

## Setup and installation
<a name="linux_setup"></a>

Download and install the WorkSpaces Linux client application from [Amazon WorkSpaces Client Downloads](https://clients.amazonworkspaces.com/). Detailed installation instructions are included on the Linux client page on the Client Downloads site.

### 2023.x clients
<a name="w2aab9c14b9b9b1"></a>

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

`workspacesclient`

**Note**  
When running a new client application, you will be prompted for your registration code, which is can be found in your welcome email. For existing customers, you can find the registration code under `/home/UserName/.local/share/Amazon Web Services/Amazon WorkSpaces/RegisterationList.json`.

### 3.x and 4.x clients
<a name="w2aab9c14b9b9b3"></a>

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

`/opt/workspacesclient/workspacesclient`

## Connecting to your WorkSpace
<a name="linux_connecting"></a>

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.

1. 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.

1. 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
<a name="manage-login-info-linx"></a>

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.

### 2023.x clients
<a name="w2aab9c14c13b5b1"></a>

**To manage your login information for a WorkSpace**

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

1. In the **Settings** dialog box, you can see the registration code and Region information for your WorkSpace.

1. (Optional) If you want the WorkSpaces client to remember your current registration code, enable **Save registration code**.

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

1. In the **WorkSpace name** box, enter a name for the WorkSpace.

1. (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.

1. Choose **Save**.

### 3.x and 4.x clients
<a name="w2aab9c14c13b5b3"></a>

**To manage your login information for a WorkSpace**

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

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

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

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

1. In the **WorkSpace name** box, enter a name for the WorkSpace.

1. (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.

1. Choose **Save**.

## Client views
<a name="linux_views"></a>

### Full screen mode for 2023.x clients
<a name="w2aab9c14c15b3b1"></a>

You can switch to full screen mode by selecting the full screen icon 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 **Leave Full Screen** in the client application menu.

### Full screen mode for 3.x and 4.x clients
<a name="w2aab9c14c15b3b3"></a>

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\$1Alt\$1Enter.

## Client language
<a name="linux_client_lang"></a>

### 2023.x clients
<a name="w2aab9c14c17b3b1"></a>

The WorkSpaces client automatically selects the default display language used by the operating system on your computer. 

### 3.x and 4.x clients
<a name="w2aab9c14c17b3b3"></a>

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**.

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

1. Restart the client.

## Display support
<a name="linux-display-support"></a>

WorkSpaces WorkSpaces Value, Standard, Performance, Power, PowerPro, and GPU-enabled 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**  
You can only extend the display. You cannot duplicate the display. Duplicating the display will cause your session to be disconnected.

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 [Enabling high DPI display for WorkSpaces](high_dpi_support.md).

**To use multiple monitors with WorkSpaces**

1. Configure your local machine to use multiple monitors. 

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

1. Depending on which client you're using, do one of the following:
**Note**  
If you are using client version is 2023.x with DCV WorkSpaces, and if there are three or more monitors connected, your WorkSpace can also extend full-screen across a selection of those available monitors. Selected monitors must be set adjacent or sharing a side with each other, in your display setting. DCV multi-monitor support is built using DCV technology. For more information about requirements and troubleshooting, see [ Extending full-screen across selected monitors](https://docs.aws.amazon.com/dcv/latest/userguide/full-screen-selected-monitors.html).    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)

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\$1F10 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
<a name="linux_proxy_server"></a>

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.

### Using a proxy server
<a name="w2aab9c14c21b7"></a>

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.

#### 2023.x clients
<a name="w2aab9c14c21b7b7b1"></a>

#### To use a proxy server


1. In the WorkSpaces client application, from the login page, choose the three-line menu icon, **Connection Settings**.

1. In the **Connection Settings** dialog box, choose **Customize proxy server for WorkSpaces** , enter the proxy server URL or IP address, enter the port, and choose **Save**.

#### 3.x and 4.x clients
<a name="w2aab9c14c21b7b7b3"></a>

#### To use a proxy server


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

1. 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
<a name="linux_shortcuts"></a>

The PCoIP WorkSpaces Linux client supports the following command shortcuts:
+ Ctrl\$1Alt\$1Enter—Toggle full screen display (PCoIP only)

## Clipboard redirection
<a name="linux_clipboard"></a>

Clipboard supports a maximum uncompressed object size of 20 MB. For more information, see [ I'm having trouble copying and pasting](https://docs.aws.amazon.com/workspaces/latest/userguide/client_troubleshooting.html).

## Disconnect
<a name="linux_disconnect"></a>

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

### 2023.x clients
<a name="w2aab9c14c27b5b1"></a>
+ In theWorkSpaces streaming session, end the WorkSpace session by closing the window. In the dialog box, choose **Disconnect** to end your WorkSpace session. The client application will continue running if you want to login again.
+ In the WorkSpaces streaming session, end your WorkSpace session by clicking on the three-line menu icon and choosing **Disconnect**. The client application will continue running, which allows you to login again.

### 3.x and 4.x clients
<a name="w2aab9c14c27b5b3"></a>
+ 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 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 prompt choose **End Session **, this disconnects you from the Amazon WorkSpaces and closes the client application. 

### Diagnostic log upload
<a name="linux-disconnect-diagnostic-log-upload"></a>

To troubleshoot issues with the WorkSpaces client, ensure that diagnostic logging is enabled for your client. The log files that are sent to WorkSpaces include detailed information about your device and connection to the AWS network. You can enable diagnostic log uploads before or during WorkSpace streaming sessions so that these files are sent to WorkSpaces automatically.

**Note**  
You can send log files before and during WorkSpaces streaming sessions. Log upload is supported only on Linux Ubuntu 20.04 and Ubuntu 22.04 clients.

**To send log files**

1. Open your Amazon WorkSpaces client.

1. In the top right of the WorkSpaces sign-in page after registration, choose **Settings** and then **Diagnostic logging**.

1. In the pop-up dialog box, set the toggle under **Diagnostic Logging** to your desired preference and choose **Save**.

1. You can choose the amount of data you want to provide in your session logs by selecting a radio button under **Log Level**. You can choose either **Standard logging (default)** or **Advance logging**.
**Important**  
When you report an issue to Support, ensure you keep track of the device ID of the client that is experiencing the issue. The device ID can be found in the settings diagnostics logging menu on the client login page after entering a registration code. This helps the support team identify logs associated with your specific device. Include the device ID in the tickets that you create regarding your specific issue.

## Release notes
<a name="linux-release-notes"></a>

### WorkSpaces client application for Ubuntu 24.04 release notes
<a name="linux-2404-client-release-notes"></a>

The following table describes the changes to each release of the Ubuntu 24.04 client application.


| Release | Date | Changes | 
| --- | --- | --- | 
| 2025.1 | December 12, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 

### WorkSpaces client application for Ubuntu 22.04 release notes
<a name="linux-2204-client-release-notes"></a>

The following table describes the changes to each release of the Ubuntu 22.04 client application.


| Release | Date | Changes | 
| --- | --- | --- | 
| 2025.1 | December 12, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2025.0 | May 28, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.8 | December 11, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.7 | October 10, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.5 | August 26, 2024 |  Bug fixes and enhancements.  | 
| 2024.4 | August 15, 2024 |  Bug fixes and enhancements.  | 
| 2024.3 | August 8, 2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2024.2 | July 3, 2024 |  Bug fixes and enhancements.  | 
| 2024.1 | June 11, 2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2024.0 | February 28, 2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.2 | December 19, 2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.1 | November 12, 2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.0.4395 | August 24, 2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) Uniform Resource Identifier (URI) is not supported in this version. For more information, see [ Customize how users log in to their WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/customize-workspaces-user-login.html) | 

### WorkSpaces client application for Ubuntu 20.04 release notes
<a name="linux-2004-client-release-notes"></a>

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


| Release | Date | Changes | 
| --- | --- | --- | 
| 2025.1 | December 12, 2025 |  Bug fixes and enhancements.  | 
| 2025.0 | May 28, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.8 | December 11, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.7 | October 10, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 2024.6 | September 5, 2024 | Bug fixes and enhancements. | 
| 2024.5 | August 26, 2024 |  Bug fixes and enhancements.  | 
| 2024.4 | August 15, 2024 |  Bug fixes and enhancements.  | 
| 2024.3 | August 8, 2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2024.2 | July 3, 2024 |  Bug fixes and enhancements.  | 
| 2024.1 | June 11, 2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2024.0 | February 28, 2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.2 | December 19, 2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.1 | November 12, 2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 4.7.0 | November 1, 2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) | 
| 2023.0.4430 | August 24, 2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html) Uniform Resource Identifier (URI) is not supported in this version. For more information, see [ Customize how users log in to their WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/customize-workspaces-user-login.html) | 
| 4.6.0 | June 21, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 4.5.0 | December 27, 2022 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-linux-client.html)  | 
| 4.4.0 | October 27, 2022 |  Ubuntu 20.04 support.  | 

# WorkSpaces macOS client application
<a name="amazon-workspaces-osx-client"></a>

The following information helps you get started with the WorkSpaces macOS client application.

**Topics**
+ [Requirements](#osx-requirements)
+ [Setup and installation](#osx_setup)
+ [Determine your client version](#determine-version-osx)
+ [Connect to your WorkSpace](#osx_connecting)
+ [Manage your login information (3.0\$1 clients only)](#manage-login-info-osx)
+ [Client views](#osx_views)
+ [Client language](#osx_client_lang)
+ [Display support](#osx-display-support)
+ [Proxy servers](#osx_proxy_server)
+ [IPv6 network settings](#osx_ipv6_settings)
+ [Command shortcuts](#osx_shortcuts)
+ [Remap the Windows logo key or the Command key](#osx_remap_command_key)
+ [Disconnect](#osx_disconnect)
+ [Clipboard support](#osx_clipboard_support)
+ [Diagnostic log upload](#diagnostic-log-uploads-osx)
+ [Release notes](#osx-release-notes)

## Requirements
<a name="osx-requirements"></a>

The Amazon WorkSpaces client for macOS requires an Apple supported version of macOS. For more details, please refer to the [macOS Release Notes](https://developer.apple.com/documentation/macos-release-notes) on the *Apple Developer Documentation* site.

The versions that are currently supported are listed in the following table:


| macOS version | PCoIP | DCV | 
| --- | --- | --- | 
| 12 (Monterey) and earlier | Not supported | Not supported | 
| 13 (Ventura) | Supported | Supported | 
| 14 (Sonoma) | Supported | Supported | 
| 15 (Sequoia) | Not supported | Supported | 

## Setup and installation
<a name="osx_setup"></a>

Download and install the latest version of the Amazon WorkSpaces client application from the [Amazon WorkSpaces Client Download](https://clients.amazonworkspaces.com/) website.

### Updating the client application
<a name="osx_update_client"></a>

The Amazon WorkSpaces client application on macOS will automatically check for available updates, and when new versions become available, will install them in the background when you’re not using it. Once the installation is complete, you simply need to open the client to begin using the latest version. This will provide you with faster access to the latest features, enhancements, and bug fixes without interrupting your productivity.

**Note**  
Automatic client updates are only applied when your client application is used to connect to WorkSpaces in the below regions.


| Region | Address | 
| --- | --- | 
|  US East (N. Virginia)  |  us-east-1  | 
|  US West (Oregon)  |  us-west-2  | 
|  Africa (Cape Town)  |  af-south-1  | 
|  Asia Pacific (Mumbai)  |  ap-south-1  | 
|  Asia Pacific (Seoul)  |  ap-northeast-2  | 
|  Asia Pacific (Singapore)  |  ap-southeast-1  | 
|  Asia Pacific (Sydney)  |  ap-southeast-2  | 
|  Asia Pacific (Tokyo)  |  ap-northeast-1  | 
|  Canada (Central)  |  ca-central-1  | 
|  Europe (Frankfurt)  |  eu-central-1  | 
|  Europe (Ireland)  |  eu-west-1  | 
|  Europe (London)  |  eu-west-2  | 
|  Europe (Paris)  |  eu-west-3  | 
|  Israel (Tel Aviv)  |  il-central-1  | 
|  South America (São Paulo)  |  sa-east-1  | 

In any other regions not listed above, the Amazon WorkSpaces client application on macOS will not update automatically; you will instead see a message when a new version is available, and will have the option to install it.

## Determine your client version
<a name="determine-version-osx"></a>

To see which version of the WorkSpaces client you have, choose **Amazon WorkSpaces**, **About Amazon WorkSpaces**, or click the gear icon in the upper-right corner and choose **About Amazon WorkSpaces**.

## Connect to your WorkSpace
<a name="osx_connecting"></a>

To connect to your WorkSpace, complete the following procedure.

### To connect to your WorkSpace for 3.0\$1 clients
<a name="osx_connecting-new-clients"></a>

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.

1. 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.

1. 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 macOS 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\$1 clients only)
<a name="manage-login-info-osx"></a>

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**.

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

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

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

1. In the **WorkSpace name** box, enter a name for the WorkSpace.

1. (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.

1. Choose **Save**.

## Client views
<a name="osx_views"></a>

You can switch to full screen mode by choosing **View**, **Enter Full Screen** (3.0\$1 clients) 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** (3.0\$1 clients) in the client application menu.

You can also toggle full screen mode by pressing Command\$1Option\$1Return.

## Client language
<a name="osx_client_lang"></a>

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

**Note**  
The WorkSpaces client applications support Japanese. However, Japanese WorkSpaces are available only in the Asia Pacific (Tokyo) Region.

**To select the client language**

1. Depending on which client you're using, do one of the following.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)

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

1. Restart the client.

## Display support
<a name="osx-display-support"></a>

WorkSpaces WorkSpaces Value, Standard, Performance, Power, PowerPro, and GPU-enabled 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**  
You can only extend the display. You cannot duplicate the display. Duplicating the display will cause your session to be disconnected.

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 [Enabling high DPI display for WorkSpaces](high_dpi_support.md).

**Note**  
If your screen resolution in WorkSpaces is low and objects look blurry, you need to turn on high DPI mode and adjust the display scaling settings on your Mac. For more information, see [Enabling high DPI display for WorkSpaces](high_dpi_support.md).

**To use multiple monitors with WorkSpaces**

1. Configure your local machine to use multiple monitors. For more information, see [Connect one or more external displays with your Mac](hhttps://support.apple.com/guide/mac-help/connect-an-external-display-mchl7c7ebe08/mac) in the Apple documentation.

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

1. Depending on which client you're using, do one of the following:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)

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**  
To use full screen mode on only some of the displays in a multiple monitor setup, press and hold the Option key and then click the green maximize button ![\[Maximize button in the top-left corner of the WorkSpaces window\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/mac-maximize-button.png) in the top-left corner of the WorkSpaces window. This button expands the WorkSpaces client window to full size on a screen without extending the WorkSpace to the other displays. To return to the previous window size, press and hold the Option key and click the maximize button again.

## Proxy servers
<a name="osx_proxy_server"></a>

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 for 3.0\$1 clients
<a name="osx_proxy_server-new-clients"></a>

By default, the 3.0\$1 macOS clients use 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**  
If you specify a custom proxy server, a "No network" error might appear when you attempt to log in to your WorkSpace. To work around this issue, use the default operating system proxy server instead of specifying a custom proxy server in the macOS client.

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

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

## IPv6 network settings
<a name="osx_ipv6_settings"></a>

The WorkSpaces client application supports connecting to your WorkSpace via IPv4, IPv6, or dual-stack (both IPv4 and IPv6). By default, IPv4 connections are used for streaming.

**To enable an IPv6 connection**

1. In the WorkSpaces client application, go to **Settings**, **Manage Connection Settings**.

1. In the **Connection Settings** dialog, under **General Connection Settings**, check the box to **Prefer IPv6-enabled communications**.

   This setting is disabled by default, meaning that your client application will exclusively use an IPv4 network for your connection. If you enable it, your client application will prioritize using an IPv6 network, but will fall back to using an IPv4 network if IPv6 is not available.

Alternatively, organizations may also configure this setting using macOS Defaults:
+ Namespace: `com.amazon.workspaces`
+ Key: `WSUseDualStackIPv6`
  + Set its value to `1` to enable IPv6 preferred.
  + Set its value to `0` to disable IPv6 preferred (meaning it will use IPv4 exclusively).
+ Changes will take effect the next time you launch the WorkSpaces client application. Users can modify this setting, but it will revert to the Defaults value when the client is relaunched.

**Note**  
IPv6 connections are supported on the WorkSpaces client application version `5.30.1` or later.
IPv6 connection settings need to be changed before connecting to your WorkSpace. They cannot be changed while connected to your WorkSpace.

## Command shortcuts
<a name="osx_shortcuts"></a>

The WorkSpaces macOS client supports the following command shortcuts:


| If you're using... | Use these shortcuts | 
| --- | --- | 
|  3.0\$1 client  |  Command\$1Q—Quit Amazon WorkSpaces Command\$1Option\$1Return—Toggle full screen display Command\$1Option\$1F12—Disconnect session  | 

## Remap the Windows logo key or the Command key
<a name="osx_remap_command_key"></a>

By default, the Windows logo key on a Windows keyboard and the Command key on an Apple keyboard are both mapped to the Ctrl key when you're using the Amazon WorkSpaces macOS client application. If you want to change this behavior so that these two keys are mapped to the Windows logo key for use with Windows WorkSpaces, use the following procedure.

**To map the Windows logo key or the Command key to the Windows logo key**

1. If you haven't already done so, [install or update](#osx_setup) to version 3.0.5 or later of the Amazon WorkSpaces macOS client application.

1. In the **Finder**, open your **Applications** folder, then open **Utilities**, and choose **Terminal**.

1. In the Terminal window, enter the following command, and then press the Return key.

   ```
   defaults write "com.amazon.Amazon WorkSpaces Client" remap_cmd_to_ctrl 0
   ```

1. In the Terminal app, choose **Terminal**, **Quit Terminal**.

1. If your WorkSpaces macOS client application is running, choose **Amazon WorkSpaces**, **Quit Amazon WorkSpaces** in the client to close the client application.

1. Restart the WorkSpaces macOS client application and log in to your WorkSpace. The Windows logo key or the Command key should now be mapped to the Windows logo key.

## Disconnect
<a name="osx_disconnect"></a>

To disconnect the macOS 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 **End Session**. 

  When ending the session, you'll be prompted to save open documents. Selecting **End Session** in the prompt will disconnect you from the WorkSpaces client user session.
**Note**  
This option is available only for WorkSpaces Pools. 
+ 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 red close (X) button in the upper-left corner. This disconnects the session and returns you to the application homepage.
+ You can also log off of the WorkSpace. In the Amazon WorkSpaces client application, go to **View**, and then choose **Send Ctrl\$1Alt\$1Delete**. Choose **Sign Out**. Your WorkSpace session ends, but the client application continues running in case you want to log in again.

## Clipboard support
<a name="osx_clipboard_support"></a>

The clipboard supports a maximum uncompressed object size of 20 MB. For more information, see [I'm having trouble copying and pasting](client_troubleshooting.md#copy_paste).

**Note**  
When copying from a Microsoft Office app, the clipboard only contains the last copied item, and the item is converted into standard format. If you copy content larger than 890 KB from a Microsoft Office app, the app might become slow or unresponsive for up to 5 seconds. 

## Diagnostic log upload
<a name="diagnostic-log-uploads-osx"></a>

### Enabling diagnostic log uploads
<a name="enabling-diagnostic-log-uploads-osx"></a>

To troubleshoot issues with the WorkSpaces client, you can enable diagnostic logging. The log files that are sent to WorkSpaces include detailed information about your device and connection to the AWS network. You can enable diagnostic log uploads before or during WorkSpace streaming sessions so that these files are sent to WorkSpaces automatically.

**To send log files:**
**Note**  
You can send log files before and during WorkSpaces streaming sessions.

1. Open your Amazon WorkSpaces client.

1. At the top of the WorkSpaces sign-in page, choose **Manage Diagnostic Logging Settings**.

1. In the pop-up dialog box, choose **Enable Diagnostic Logging for Amazon WorkSpaces** and click **Save**.
**Important**  
When you report an issue to AWS support, ensure you keep track of the device ID of the client who is experiencing the issue. This device ID can be found in the diagnostics logging menu, in the WorkSpaces client navigation bar, and it helps the support team identify logs associated with your specific device. Ensure you include the device ID in the tickets that you create regarding this specific issue.

## Release notes
<a name="osx-release-notes"></a>

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


| Release | Date | Changes | 
| --- | --- | --- | 
| 5.31.0 | January 21, 2026 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.30.2 | November 3, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.30.1 | October 21, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.30.0 | October 13, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.29.1 | August 6, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.29.0 | July 31, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.28.1 | July 2, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.27.0 | April 30, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.26.2  | April 1, 2025 | Bug fixes and enhancements. | 
| 5.26.0 | March 4, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.25.0 | December 19, 2024 | Bug fixes and enhancements. | 
| 5.24.0 | November 22, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.23.1 | October 17, 2024 |  Bug fixes and enhancements.  | 
| 5.23.0 | September 30, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.22.1 | September 3, 2024 |  Bug fixes and enhancements.  | 
| 5.22.0 | August 16, 2024 | Updated the DCV SDK. | 
| 5.21.0 | July 3, 2024 |  Bug fixes and enhancements.  | 
| 5.20.0 | June 13, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.19.3 | April 30, 2024 |  Fixed issue where users get immediately disconnected from their DCV WorkSpaces when connecting to it.  | 
| 5.19.0 | February 28, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.18.0 | January 22, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.17.0 | November 16, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.16.0 | October 26, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.15.1 | September 20, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.12.0 | August 29, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.11.0 | June 29, 2023 |  Added options to enable or disable **Ctrl** \$1 left-click as right-click and enable or disable mapping the **Command** key to the **Ctrl** key. To access both options, from the menu bar, choose **Settings**, **Manage Modifier Keys**.  | 
| 5.10.0 | June 19, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.9.0 | May 9, 2023 |  Updated DCV SDK to fix playback volume issues.  | 
| 5.8.0 | April 6, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.7.0 | February 23, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.6.0 | December 27, 2022 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 5.5.0 | November 14, 2022 | Updated the DCV client SDK. | 
| 5.4.0 | November 10, 2022 | Added a shortcut Command\$1Alt\$1F12 to disconnect your WorkSpaces. | 
| 5.3.0 | September 15, 2022 |  Bug fixes and enhancements.  | 
| 5.2.0 | August 24, 2022 |  Fixed WorkSpaces login issue when using Smart Card.  | 
| 5.1.0 | June 30, 2022 |  Updated PCoIP SDK for MacOS.  | 
| 4.0.7 | March 3, 2022 | Fixed a WorkSpaces connection error caused by the Proxy settings on MacBook. | 
| 4.0.6 | December 21, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 4.0.5 | November 23, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 4.0.4 | November 3, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 4.0.3 | October 4, 2021 | Bug fixes and enhancements. | 
| 4.0.2 | September 8, 2021 | Minor bug fixes and enhancements. | 
| 4.0.1 | August 5, 2021 | Minor bug fixes and enhancements. | 
| 3.1.9 | June 29, 2021 | Minor bug fixes and enhancements. | 
| 3.1.8 | May 28, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 3.1.7 | April 29, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 3.1.6 | April 8, 2021 |  Fixes for disconnects and crashes resulting from DCV audio traffic optimization  | 
| 3.1.5 | April 2, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 3.1.4 | March 16, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 3.1.3 | February 15, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 3.1.2 | January 8, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 3.1.0 | December 1, 2020 |  Minor bug fixes and enhancements  | 
| 3.0.12 | November 10, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 3.0.11 | October 02, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
| 3.0.10 | September 16, 2020 |  Adds support for health checks over port 4195 (UDP and TCP)  | 
| 3.0.9 | August 14, 2020 |  Minor bug fixes and enhancements  | 
| 3.0.8 | July 30, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  3.0.7  | June 3, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  3.0.6  | April 28, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  3.0.5  | March 30, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  3.0.4  | March 3, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  3.0.3  | February 24, 2020 |  Improves readability on high DPI devices  | 
|  3.0.2  | February 14, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  3.0.0  | November 25, 2019 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.5.11  | November 4, 2019 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.5.9  |  |  Minor bug fixes  | 
|  2.5.8  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.5.7  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.5.6  |  |  Minor fixes  | 
|  2.5.5  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.5.2  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.5.1  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.5.0  |  |  Adds support for user self-service WorkSpace management capabilities  | 
|  2.4.10  |  |  Minor fixes  | 
|  2.4.9  |  |  Minor fixes  | 
|  2.4.8  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.4.7  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.4.6  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.4.4  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.4.2  |  |  Minor fixes  | 
|  2.4.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.3.7  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.3.6  |  |  Localization enhancements  | 
|  2.3.5  |  |  Minor improvements  | 
|  2.3.3  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.3.1  |  |  Minor fixes  | 
|  2.3.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.2.3  |  |  Resolves minor bugs and improves stability  | 
|  2.2.1  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.1.4  |  |  Resolves a crash issue on macOS Sierra  | 
|  2.1.3  |  |  Closing the client expires the reconnect token. You can easily reconnect to your WorkSpace as long as the client is running.  | 
|  2.1.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.0.8  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  2.0.4  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  1.1.80  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  1.1.6  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  1.1.4  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  1.0.8  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-osx-client.html)  | 
|  1.0  |  |  Initial release  | 

# WorkSpaces PCoIP zero client
<a name="amazon-workspaces-pcoip-zero-client"></a>

You can set up and use a PCoIP zero client device with WorkSpaces. 

## Requirements
<a name="zero_client_reqs"></a>

To use a PCoIP zero client with WorkSpaces, you need the following:
+ PCoIP zero clients are compatible only with WorkSpaces that are using the PCoIP protocol.
+ Your Tera2 zero client device must have firmware version 6.0.0 or later. If your Tera2 zero client device has a firmware version between 4.6.0 and 6.0.0, your WorkSpaces administrator must upgrade your device firmware through a Desktop Access subscription at [https://www.teradici.com/products/zero-clients\$1buy](https://www.teradici.com/products/zero-clients#buy).
+ WorkSpaces multi-factor authentication (MFA) requires a Tera2 zero client device with firmware version 6.0.0 or later.
+ Your WorkSpaces administrator might need to enable your zero client device to use USB printers and other USB peripheral devices. If you're having trouble using a USB printer or other USB peripheral devices, contact your WorkSpaces administrator for assistance. For more information, see [ USB printers and other USB peripherals aren't working for PCoIP zero clients](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html#pcoip_zero_client_usb) in the *Amazon WorkSpaces Administration Guide*.

For a list of approved PCoIP zero client devices, see [PCoIP Zero Clients](https://www.teradici.com/resource-center/product-service-finder/pcoip-zero-clients) on the Teradici website.

## Connect to your WorkSpace
<a name="zero_client_connect"></a>

If your zero client device has firmware version 6.0.0 or later, you can connect to your WorkSpace. If your zero client device has a firmware version between 4.6.0 and 6.0.0, your WorkSpaces administrator must upgrade your device firmware through a Desktop Access subscription at [https://www.teradici.com/desktop-access](https://www.teradici.com/desktop-access).

**To connect to your WorkSpace**

1. From the PCoIP zero client device, choose **Options**, **Configuration**, **Session**, and choose the **OSD: WorkSpaces Session Settings** connection type.

1. Enter the registration code from your welcome email.

1. Enter a name for this registered WorkSpace.

1. Choose **Connect**.

## Disconnect from the zero client
<a name="zero_client_disconnect"></a>

To disconnect the zero client from your WorkSpace, you can press Ctrl\$1Alt\$1F12. Alternatively, you can log off of the WorkSpace, which disconnects the client.

## IPv6 network settings
<a name="zero_client_ipv6_settings"></a>

The WorkSpaces PCoIP zero client application supports connecting to your WorkSpace via IPv4, IPv6, or dual-stack (both IPv4 and IPv6).

You can refer to the PCoIP Zero Client documentation to [configure IPv6 settings](https://anyware.hp.com/web-help/pcoip_zero_client/tera2/23.06/configuring_ipv6_settings/).

**Note**  
IPv6 connections are supported on the Zero Client firmware version `25.10` or later.
When IPv6 is enabled for a Zero client application, the system will exclusively use IPv6 networking and will not automatically switch to IPv4 if an IPv6 connection is unavailable.

# WorkSpaces Web Access
<a name="amazon-workspaces-web-access"></a>

**Note**  
As of November 7, 2025, Amazon WorkSpaces PCoIP Web Access is no longer open to new customers. The feature will only receive critical functional and security updates going forward. While existing users can continue using the feature, new users will not be able to connect to their PCoIP WorkSpaces using Web Access.  
For continued Web Access usage, we recommend evaluating [migration to DCV protocol](https://aws.amazon.com/blogs/desktop-and-application-streaming/seamlessly-modify-existing-amazon-workspaces-to-use-the-workspaces-streaming-protocol/), which has Web Access support that offers improved performance and enhanced features including SAML and certificate-based authentication. Alternatively, PCoIP users can switch to [WorkSpaces client applications](https://clients.amazonworkspaces.com/) for full feature support.

You can access your DCV-based Windows and Linux-based WorkSpaces from the convenience of your web browser. You may choose this option if you prefer not to install one of the Amazon WorkSpaces client applications, or if you are accessing your WorkSpace from a personal device.

The following information will help you get started with WorkSpaces web access.

**Requirements**
+ Your administrator must enable web access on your WorkSpace. For more information, check with your administrator or see [Enable and Configure WorkSpaces Web Access](https://docs.aws.amazon.com/workspaces/latest/adminguide/web-access.html) in the Amazon WorkSpaces Administration Guide.
+ Web access is supported with DCV-based WorkSpaces where the WorkSpace is running Windows or Linux.
  + On Windows, macOS, and Linux devices: Web access for Amazon DCV is supported on Google Chrome, Microsoft Edge, Apple Safari and Mozilla Firefox browsers when running on the latest three browser versions.
  + On Android tablets, Chromebooks, and iPads: Web access for Amazon DCV is supported on Google Chrome and Apple Safari browsers when running on the latest three browser versions.
+ Web access for PCoIP-based WorkSpaces has the following limitations:
  + Web access for PCoIP is not supported in the AWS GovCloud (US), Asia Pacific (Mumbai), Africa (Cape Town), Israel (Tel Aviv), or Europe (Paris) regions.
  + Web access for PCoIP is only supported for Windows-based WorkSpaces, not Linux-based WorkSpaces.
  + Web access for PCoIP is only supported on Google Chrome and Mozilla Firefox browsers on Windows, macOS and Linux devices when running on the latest three browser versions.
  + Web access for PCoIP does not support multiple monitors.
  + Web access for PCoIP does not support connecting to GPU-enabled WorkSpaces.

**Note**  
YUV444 encoding is not supported with WorkSpaces web access. If your administrator uses a Group Policy setting to enable YUV444 encoding, this may cause issues during login or rendering issues during your session.

**Topics**
+ [Display support](#web-access-views)
+ [Proxy servers](#web-access-proxy)
+ [Supported features for DCV-based WorkSpaces](#wsp-for-wsp-client)
+ [Supported features and gestures on Android tablets and iPads](#supported-features-tablets)
+ [Enabling diagnostic log uploads](#enable-diagnostic-logging)

## Display support
<a name="web-access-views"></a>

WorkSpaces Web Access supports up to two monitors when connecting to DCV-based WorkSpaces.

## Proxy servers
<a name="web-access-proxy"></a>

If you are required to use a proxy server to access the internet, you can configure your browser to use the proxy server.

**Requirements**
+ Proxy with authentication is not currently supported.
+ Proxy server support for Web Access may vary by browser. Refer to your browser’s proxy settings for more information.

## Supported features for DCV-based WorkSpaces
<a name="wsp-for-wsp-client"></a>

The following features are supported for DCV-based WorkSpaces.

### Copying and pasting
<a name="web-client-copy-paste"></a>

You can use the web client to copy and paste plain text and PNG images between your local device and the WorkSpaces session. On Google Chrome and Microsoft Edge, you can use keyboard shortcuts and context (right-click) menu to copy and paste text and images. On Mozilla Firefox and Apple Safari you can use the clipboard dialog to copy and paste plain text; images are not supported.

### Using a webcam
<a name="web-client-webcam"></a>

Webcam functionality is supported on Google Chrome and Microsoft Edge. On Mozilla Firefox, webcams are supported with Windows-based WorkSpaces only. Webcams are not supported on Apple Safari.

**Selecting the webcam you want to use**

1. Choose the drop-down with your **Workspaces Name** on the top right of your WorkSpaces session, and then choose **Preferences**.

1. Choose the **Audio and Video** tab, scroll down to **Camera**, and then select the camera to use.

1. Select **Save**.

**Note**  
Cameras will appear only if your administrator has enabled webcam support for your WorkSpace. You can't change the webcam selection while the webcam is in use.

**Using a webcam during your session**

Toggle the webcam button in the client toolbar as shown below to enable or disable your webcam during your session. The webcam button appears on the toolbar only if webcam support is enabled and at least one webcam is connected to your local device.

![\[The webcam button in the WorkSpaces Web Access client.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/webaccess-webcam-button.png)


The following table shows different webcam states:


| Icon | Description | 
| --- | --- | 
|  ![\[The webcam is disabled.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/webaccess-webcam-disabled.png)  |  The webcam is disabled. Toggle the button to enable the webcam. If you didn't previously select the webcam to use, the default webcam is used.  | 
|  ![\[The webcam is enabled.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/webaccess-webcam-enabled.png)  |  The webcam is enabled, but it's not in use. Toggle the button to disable the webcam.  | 
|  ![\[The webcam is in use.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/webaccess-webcam-inuse.png)  |  The webcam is in use by a remote application in the WorkSpaces session. Toggle the button to disable the webcam.  | 

### Using multiple screens
<a name="web-client-multiple-screens"></a>

To use multiple screens, choose the multiscreen button in the client as shown in the following example. Multiple screens are supported with up to two monitors.

![\[The multiscreen button in the WorkSpaces Web Access client.\]](http://docs.aws.amazon.com/workspaces/latest/userguide/images/webaccess-multiscreen-button.png)


## Supported features and gestures on Android tablets and iPads
<a name="supported-features-tablets"></a>

Android tablets are supported on Google Chrome, and iPads are supported on Apple Safari. Touch input is supported for both device types.

**Gestures**
+ Use a two-finger single tap gesture or use the client toolbar button to toggle the on-screen keyboard.
+ Use a pinch gesture to zoom in our out on the screen. When zoomed in, use a two-finger slide gesture to pan the screen horizontally or vertically.
+ Use a three-finger single tap gesture to show the client toolbar when it has been hidden by auto-hide.

**Trackpad mode**
+ To enable track pad mode, choose the drop-down with your **WorkSpace Name** on the top right of your WorkSpaces session, and then choose **Enable trackpad mode**.
+ Once trackpad mode is enabled:
  + Use a short one-finger tap to trigger a mouse left click.
  + Use a longer one-finger tap to trigger a mouse right click.

**Screen resolution and other functionality**
+ Your screen resolution may be automatically adjusted to fit the tablet screen size.
+ If you rotate the tablet device, the screen will automatically resize itself.
+ Full screen is not supported on Apple Safari on iPads.

## Enabling diagnostic log uploads
<a name="enable-diagnostic-logging"></a>

To troubleshoot issues with WorkSpaces web access, you can enable diagnostic logging. The log files that are sent to AWS include detailed information about your device and connection to the AWS network. You can enable automatic diagnostic log uploads before or during your WorkSpace streaming sessions.

**To send log files**

1. Open the Amazon WorkSpaces Web Access page. If you’re currently in your WorkSpaces session, disconnect from it so you return to the pre-session page.

1. At the top of the pre-session page, choose **Settings**, then **Diagnostic logging**.

1. Ensure **Diagnostic logging** is enabled.

1. (Optional) To generate debugging-level details and verbose performance data, choose **Advanced logging**.

# WorkSpaces Windows client application
<a name="amazon-workspaces-windows-client"></a>

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

**Topics**
+ [Requirements](#windows-requirements)
+ [Setup and installation](#windows_setup)
+ [Determine your client version](#determine-version-windows)
+ [Client application updates](#windows_update_client)
+ [IPv6 network settings](#ipv6-network-settings)
+ [Connect to your WorkSpace](#windows_connecting)
+ [Manage your login information (3.0\$1 clients only)](#manage-login-info-windows)
+ [Client views](#windows_views)
+ [Client language](#windows_client_lang)
+ [Display support](#windows-display-support)
+ [Proxy servers](#windows_proxy_server)
+ [Command shortcuts](#windows_shortcuts)
+ [Disconnect](#windows_disconnect)
+ [Clipboard support](#windows_clipboard_support)
+ [Manage hardware acceleration](#windows_hardware_acceleration)
+ [Diagnostic log upload](#diagnostic-log-uploads-users)
+ [Release notes](#windows-release-notes)

## Requirements
<a name="windows-requirements"></a>
+ The Amazon WorkSpaces client for Windows requires a Microsoft supported version of Windows 11 or Windows 10. For more details, please see Microsoft’s guidance here: [Windows 11 release information](https://learn.microsoft.com/en-us/windows/release-health/windows11-release-information) or [Windows 10 release information](https://learn.microsoft.com/en-us/windows/release-health/release-information).

## Setup and installation
<a name="windows_setup"></a>

Download and install the latest version of the Amazon WorkSpaces client application from [Amazon WorkSpaces Client Download](https://clients.amazonworkspaces.com/).

You have two choices for how to install the Amazon WorkSpaces client application: 
+ **Install just for you**. If you choose this option and you share your local machine with other users, the WorkSpaces client application is available only to you. If other users on the machine also want to use the WorkSpaces client application, they must install the application for their own use. 
+ **Install for all users of this machine**. If you choose this option, the WorkSpaces client application is available to anyone who logs on to the local machine, including those with Guest accounts. 

Installing the WorkSpaces client application for all users requires you to have administrator privileges on your local machine. Depending on how your local machine is configured, you might not have such privileges. In that case, you can install the WorkSpaces client application just for yourself. If you have questions about which option to choose, ask your WorkSpaces administrator for guidance.

### Installing the USB redirection driver
<a name="install-usb-redirection"></a>

To use your local USB devices on the remote session, you will need to install the USB redirection driver. To install this driver, you will need to install the WorkSpaces application for all users, and then check the box to **Install driver for USB redirection**.

## Determine your client version
<a name="determine-version-windows"></a>

To see which version of the WorkSpaces client you have, choose **Amazon WorkSpaces**, **About Amazon WorkSpaces**, or click the gear icon in the upper-right corner and choose **About Amazon WorkSpaces**.

## Client application updates
<a name="windows_update_client"></a>

The Amazon WorkSpaces client application on Windows will automatically check for available updates, and when new versions become available, will install them in the background when you’re not using it. Once the installation is complete, you simply need to open the client to begin using the latest version. This will provide you with faster access to the latest features, enhancements, and bug fixes without interrupting your productivity.

Client updates maintain the same installation context as the original installation. This means if the Amazon WorkSpaces client was originally installed for all users on the local machine, future automatic updates will apply to all users. Similarly, if the client was installed for a single user, future updates will only apply to that specific user. Should you need to change this behavior, you can uninstall the client application and reinstall it under your preferred installation context.

**Note**  
Automatic client updates are only applied when your client application is used to connect to WorkSpaces in the following regions.


| AWS Region | Address | 
| --- | --- | 
|  US East (N. Virginia)  |  us-east-1  | 
|  US West (Oregon)  |  us-west-2  | 
|  Africa (Cape Town)  |  af-south-1  | 
|  Asia Pacific (Mumbai)  |  ap-south-1  | 
|  Asia Pacific (Seoul)  |  ap-northeast-2  | 
|  Asia Pacific (Singapore)  |  ap-southeast-1  | 
|  Asia Pacific (Sydney)  |  ap-southeast-2  | 
|  Asia Pacific (Tokyo)  |  ap-northeast-1  | 
|  Canada (Central)  |  ca-central-1  | 
|  Europe (Frankfurt)  |  eu-central-1  | 
|  Europe (Ireland)  |  eu-west-1  | 
|  Europe (London)  |  eu-west-2  | 
|  Europe (Paris)  |  eu-west-3  | 
|  Israel (Tel Aviv)  |  il-central-1  | 
|  South America (São Paulo)  |  sa-east-1  | 

In any other regions not listed above, the Amazon WorkSpaces client application on Windows will not update automatically; you will instead see an message when a new version is available, and will have the option to install it.

### Opting out from automatic updates (Windows client only)
<a name="opt-out-auto-updates"></a>

We encourage you to take advantage of the new automatic client update feature so you always have access to the latest features, security patches, and bug fixes. However, if you or your administrator want to manage client updates manually, you can opt out by following these steps for Windows clients.

**Note**  
Opting out from automatic updates is supported for the Windows client application only.

Administrator privileges are required on the local device.

#### To disable automatic updates:
<a name="disable-automatic-updates"></a>

1. Open the by Type "registry editor" in the Windows search box.

1. Right-click on **Registry Editor** and select **Run as administrator**.

1. If prompted for permission, choose **Yes**.

1. Open a command line.

1. Navigate to: `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\`.

1. If it does not already exist, create a new Key called "Amazon WorkSpaces Client".

1. Within this key, create a new String Value named "clientUpgradeDisabled" and set its value to 1.

1. Either restart your computer or do the following to apply the changes:

   1. Open the **Task Manager**.

   1. Go to the **Processes** tab.

   1. Search for one of the following:
      + For an "all users" installation, search for `WorkSpacesService.exe`.
      + For a "single user" installation, search for `WorkSpacesHelper.exe`.

   1. Right-click and select **End process**.

1. For organizations managing multiple Windows devices, this registry setting can be deployed using Group Policy:

   ```
   HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\Amazon WorkSpaces Client\clientUpgradeDisabled 
   Type: REG_SZ
   Value: 1
   ```

## IPv6 network settings
<a name="ipv6-network-settings"></a>

The WorkSpaces Windows client application supports connecting to your WorkSpace using IPv4, IPv6, or dual-stack (both IPv4 and IPv6) addresses. By default, IPv4 connections are used for streaming. IPv6 connections are disabled by default, meaning that your client application will exclusively use an IPv4 network for your connection. If you enable IPv6 connections, your client application will prioritize using an IPv6 network, but will fall back to using an IPv4 network if IPv6 is not available.

**Note**  
IPv6 connections are supported on the WorkSpaces client application version 5.30.1 or later.  
You cannot change IPv6 connection settings if you are connected to your WorkSpace. Change the setting before connecting to your WorkSpace.

Use the following procedure to enable IPv6 connections.

### To enable an IPv6 connection
<a name="enable-ipv6"></a>

1. In the WorkSpaces client application, navigate to **Settings >, Manage Connection Settings**.

1. Under **General Connection Settings**, choose **Prefer IPv6-enabled communications**. 

Alternatively, you can also enable IPv6 connections by using the following registry key:

1. On the Windows client, enter **registry editor** in the Windows search bar.

1. Right-click on **Registry Editor** and select **Run as administrator**.

1. If prompted for permission, choose **Yes**.

1. In the Registry Editor, navigate to: `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\Amazon WorkSpaces Client\`

1. Within this key, create a new DWORD (Double Word) Value named `WSUseDualStackIPv6`.

   1. Set its value to `1` to enable IPv6 preferred connections.

     Set its value to `0` to disable IPv6 preferred connection, and enable IPv4 connections exclusively.

1. Changes you make will take effect the next time you launch the WorkSpaces client application. Users can modify this setting, but it will revert to the default registry key value when the client is relaunched.

## Connect to your WorkSpace
<a name="windows_connecting"></a>

To connect to your WorkSpace, complete the following procedure.

### To connect to your WorkSpace for 3.0\$1 clients
<a name="windows_connecting-new-clients"></a>

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.

1. 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.

1. 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 Windows 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\$1 clients only)
<a name="manage-login-info-windows"></a>

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**.

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

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

1. Under **Saved registration codes**, select the WorkSpace that you want to name.

1. In the **WorkSpace name** box, enter a name for the WorkSpace.

1. (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.

1. Choose **Save**.

## Client views
<a name="windows_views"></a>

You can switch to full screen mode by choosing **View**, **Enter Full Screen** (3.0\$1 clients) 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** (3.0\$1 clients) in the client application menu.

You can also toggle full screen mode by pressing Ctrl\$1Alt\$1Enter.

## Client language
<a name="windows_client_lang"></a>

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

**Note**  
The WorkSpaces client applications support Japanese. However, Japanese WorkSpaces are available only in the Asia Pacific (Tokyo) Region.

**To select the client language**

1. Depending on which client you're using, do one of the following.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)

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

1. Restart the client.

## Display support
<a name="windows-display-support"></a>

WorkSpaces WorkSpaces Value, Standard, Performance, Power, PowerPro, and GPU-enabled 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**  
You can only extend the display. You cannot duplicate the display. Duplicating the display will cause your session to be disconnected.

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 [Enabling high DPI display for WorkSpaces](high_dpi_support.md). 

**To use multiple monitors with WorkSpaces**

1. Configure your local machine to use multiple monitors. For more information, see [ How to use multiple monitors in Windows 10](https://support.microsoft.com/en-us/windows/how-to-use-multiple-monitors-in-windows-329c6962-5a4d-b481-7baa-bec9671f728a) in the Microsoft documentation. 

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

1. Depending on which client you're using, do one of the following:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)

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 the Windows logo key \$1 Up Arrow or use the maximize button in the upper-right corner of the WorkSpaces window to maximize the WorkSpaces client window on a display without extending the WorkSpace to the other displays.

## Proxy servers
<a name="windows_proxy_server"></a>

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 sign-in credentials are not supported.

### To control the proxy server for 3.0\$1 clients
<a name="windows_proxy_server-new-clients"></a>

By default, the 3.0\$1 Windows clients use 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. If a proxy server is specified at both the operating system level and in the WorkSpaces client, the client setting is used.

Starting with version 3.0.12 of the Windows client, you can also choose not to use a proxy server.

**Note**  
In versions 3.0.0 through 3.0.11, 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 Windows client, we recommend upgrading to the latest version.

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

1. In the **Set Proxy** dialog box, select the appropriate options, depending on which version of the 3.0\$1 client you have.
   + **Windows client version 3.1.3 or later** — To disable usage of a proxy server, select **Don't use proxy server**. If you select **Don't use proxy server**, no proxy server is used when you access the internet.

     To use a proxy server, choose one of the following options, and then choose **Save**:
     + **Use your device operating system settings** — This option uses the proxy server settings for your operating system.
     + **Customize proxy server for WorkSpaces** — Enter the URL or IP address and the port for your custom proxy server.
   + **Windows client versions 3.0.12, 3.1.0, and 3.1.2** — To enable or disable usage of a proxy server, select or deselect **Use proxy server**. If you deselect **Use proxy server**, no proxy server is used when you access the internet.

     If you've selected **Use proxy server**, choose one of the following options, and then choose **Save**:
     + **Use your device operating system settings** — This option uses the proxy server settings for your operating system.
     + **Customize proxy server for WorkSpaces** — Enter the URL or IP address and the port for your custom proxy server.
   + **Windows client version 3.0.11 or earlier** — By default, these versions of the client use the proxy server specified in the device operating system settings. To use a custom proxy server, choose **Use proxy server**, enter the URL or IP address and the port for the proxy server, and then choose **Save**.

## Command shortcuts
<a name="windows_shortcuts"></a>

The WorkSpaces Windows client supports the following command shortcuts:
+ Ctrl\$1Alt\$1Enter—Toggle full screen display
+ Ctrl\$1Alt\$1F12—Disconnect session

## Disconnect
<a name="windows_disconnect"></a>

To disconnect the Windows 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 **End Session**. 

  When ending the session, you'll be prompted to save open documents. Selecting **End Session** in the prompt will disconnect you from the WorkSpaces client user session.
**Note**  
This option is available only for WorkSpaces Pools. 
+ 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. This disconnects the session and returns you to the application homepage.
+ You can also log off of the WorkSpace. In the Amazon WorkSpaces client application, go to **View**, and then choose **Send Ctrl\$1Alt\$1Delete**. Choose **Sign Out**. Your WorkSpace session ends, but the client application continues running in case you want to log in again.

## Clipboard support
<a name="windows_clipboard_support"></a>

The clipboard supports a maximum uncompressed object size of 20 MB. For more information, see [I'm having trouble copying and pasting](client_troubleshooting.md#copy_paste).

**Note**  
When copying from a Microsoft Office app, the clipboard only contains the last copied item, and the item is converted into standard format. If you copy content larger than 890 KB from a Microsoft Office app, the app might become slow or unresponsive for up to 5 seconds. 

## Manage hardware acceleration
<a name="windows_hardware_acceleration"></a>

Starting with version 5.0.0, hardware acceleration is enabled by default when you're using the Amazon WorkSpaces Windows client application.

**Note**  
If you plan to upgrade to a version between 3.1.4 and 5.0.0, and if you've disabled hardware acceleration for version 3.1.3 or earlier by using the [procedure described later in this section](#hardware_acceleration_313), make sure that you re-enable hardware acceleration in Windows by setting the **DisableHWAcceleration** registry key to **0**. Then you can upgrade to a version between 3.1.4 and 5.0.0 of the WorkSpaces Windows client application.

If you're experiencing high CPU usage or slower performance when using the client, you might want to enable hardware acceleration in the client.

**Note**  
If you enable hardware acceleration in the Windows client, the following issues might occur with a few video driver versions:  
The screen might have flickering black boxes in some places.
The screen might not properly update on the WorkSpaces login page, or it might not properly update after you log in to your WorkSpace. You might see artifacts on the screen.
Your mouse clicks might not be lined up with the cursor position on the screen.

### To enable hardware acceleration in version 3.1.5 or later of the Windows client
<a name="hardware_acceleration_315"></a>

1. Choose **Settings**, **Manage Hardware Acceleration**.

1. In the **Manage Hardware Acceleration** dialog box, select **Enable Hardware Acceleration for Amazon WorkSpaces**, and then choose **Save**. 

1. For this change to take effect, choose **Amazon WorkSpaces**, **Quit Amazon WorkSpaces** to close the Windows client application.

1. Restart the WorkSpaces Windows client application. Hardware acceleration should now be enabled.

   After you've enabled hardware acceleration in the Windows client, if the screen and mouse issues described earlier occur, clear the **Enable Hardware Acceleration for Amazon WorkSpaces** check box to disable hardware acceleration, and then restart the Windows client application.

WorkSpaces administrators can enable hardware acceleration in version 3.1.4 or later of the WorkSpaces Windows client by using the following commands in a Command Prompt or PowerShell window.

1. Use the following command to check for the **EnableHwAcc** registry key.

   ```
   reg query "HKCU\SOFTWARE\Amazon Web Services. LLC\Amazon WorkSpaces" /v EnableHwAcc
   ```

1. Use the following command to add the **EnableHwAcc** registry key.

   ```
   reg add "HKCU\SOFTWARE\Amazon Web Services. LLC\Amazon WorkSpaces" /v EnableHwAcc
   ```

   This registry setting takes effect after the WorkSpaces Windows client is closed and restarted.

If needed, use the following command to delete the **EnableHwAcc** registry key.

```
reg delete "HKCU\SOFTWARE\Amazon Web Services. LLC\Amazon WorkSpaces" /v EnableHwAcc /f
```

This registry setting takes effect after the WorkSpaces Windows client is closed and restarted. 

### To disable hardware acceleration in version 3.1.5 or later of the Windows client
<a name="disable_hardware_acceleration_315"></a>

1. Choose **Settings**, **Manage Hardware Acceleration**.

1. In the **Manage Hardware Acceleration** dialog box, unselect **Enable Hardware Acceleration for Amazon WorkSpaces**, and then choose **Save**.

1. For this change to take effect, choose **Amazon WorkSpaces**, **Quit Amazon WorkSpaces** to close the Windows client application.

1. Restart the WorkSpaces Windows client application. Hardware acceleration should now be disabled.

### To enable hardware acceleration in version 3.1.4 of the Windows client
<a name="hardware_acceleration_314"></a>

1. On your Windows computer (not your WorkSpace), open the Windows search box, and enter **registry editor** to open the Registry Editor (**regedit.exe**). Choose **Run as administrator**. (If you don't have permission to run the Registry Editor as an administrator, contact your system administrator for assistance.)

1. When asked "Do you want to allow this app to make changes to your device?", choose **Yes**. 

1. In the Registry Editor, navigate to the following registry entry:

   **HKEY\$1CURRENT\$1USER\$1SOFTWARE\$1Amazon Web Services. LLC\$1Amazon WorkSpaces**

1. Select **Amazon WorkSpaces**, and then choose **Edit** > **New** > **String Value**.

1. For the registry key name, enter **EnableHwAcc**.

1. Close the Registry Editor.

1. Close and restart the WorkSpaces client application. 

   After you've enabled hardware acceleration in the Windows client, if the screen and mouse issues described earlier occur, delete the **EnableHwAcc** registry key to disable hardware acceleration, and then restart the Windows client application.

WorkSpaces administrators can enable hardware acceleration in version 3.1.4 or later of the WorkSpaces Windows client by using the following commands in a Command Prompt or PowerShell window.

1. Use the following command to check for the **EnableHwAcc** registry key.

   ```
   reg query "HKCU\SOFTWARE\Amazon Web Services. LLC\Amazon WorkSpaces" /v EnableHwAcc
   ```

1. Use the following command to add the **EnableHwAcc** registry key.

   ```
   reg add "HKCU\SOFTWARE\Amazon Web Services. LLC\Amazon WorkSpaces" /v EnableHwAcc
   ```

   This registry setting takes effect after the WorkSpaces Windows client is closed and restarted.

If needed, use the following command to delete the **EnableHwAcc** registry key.

```
reg delete "HKCU\SOFTWARE\Amazon Web Services. LLC\Amazon WorkSpaces" /v EnableHwAcc /f
```

This registry setting takes effect after the WorkSpaces Windows client is closed and restarted. 

### To disable hardware acceleration in version 3.1.3 or earlier of the Windows client
<a name="hardware_acceleration_313"></a>

If you need to use version 3.1.3 or earlier of the Windows client application, you can disable hardware acceleration in Windows through the Windows registry. Disabling hardware acceleration in Windows might affect the performance of other Windows applications.

1. On your Windows computer (not your WorkSpace), open the Windows search box, and enter **registry editor** to open the Registry Editor (**regedit.exe**). Choose **Run as administrator**. (If you don't have permission to run the Registry Editor as an administrator, contact your system administrator for assistance.)

1. When asked "Do you want to allow this app to make changes to your device?", choose **Yes**. 

1. In the Registry Editor, navigate to the following registry entry:

   **HKEY\$1CURRENT\$1USER\$1SOFTWARE\$1Microsoft\$1Avalon.Graphics**

1. Do one of the following:
   + If the **DisableHWAcceleration** registry key exists, select it and choose **Edit** > **Modify**. In the **Value data** box, enter **1** (to disable hardware acceleration), and then choose **OK**. 
   + If the **DisableHWAcceleration** registry key doesn't exist, do the following:

     1. Select **Avalon.Graphics**, and then choose **Edit** > **New** > **DWORD (32-bit) Value**.

     1. For the registry key name, enter **DisableHWAcceleration**.

     1. Select the new **DisableHWAcceleration** key, and then choose **Edit** > **Modify**. 

     1. In the **Value data** box, enter **1** (to disable hardware acceleration), set **Base** to **Hexadecimal**, and then choose **OK**. 

1. Close the Registry Editor.

1. Close and restart the WorkSpaces client application. 

**Note**  
If you need to enable hardware acceleration to improve the performance of other Windows applications, set the **DisableHWAcceleration** key to **0**.

## Diagnostic log upload
<a name="diagnostic-log-uploads-users"></a>

### Enabling diagnostic log uploads
<a name="enabling-diagnostic-log-uploads"></a>

To troubleshoot issues with the WorkSpaces client, you can enable diagnostic logging. The log files that are sent to WorkSpaces include detailed information about your device and connection to the AWS network. You can enable diagnostic log uploads before or during WorkSpace streaming sessions so that these files are sent to WorkSpaces automatically.

**To send log files**
**Note**  
You can send log files before and during WorkSpaces streaming sessions.

1. Open your Amazon WorkSpaces client.

1. At the top of the WorkSpaces sign-in page, choose **Manage Diagnostic Logging Settings**.

1. In the pop-up dialog box, choose **Enable Diagnostic Logging for Amazon WorkSpaces** and click **Save**.
**Important**  
When you report an issue to AWS support, ensure you keep track of the device ID of the client who is experiencing the issue. This device ID can be found in the diagnostics logging menu, in the WorkSpaces client navigation bar, and it helps the support team identify logs associated with your specific device. Ensure you include the device ID in the tickets that you create regarding this specific issue.

## Release notes
<a name="windows-release-notes"></a>

The following table describes the changes to each release of the Windows client application. As a general security best practice, we recommend that WorkSpaces customers update client software as relevant patches become available to obtain the latest updates. For additional information on all the supported WorkSpaces client versions, see [WorkSpaces client application end of life policy](https://docs.aws.amazon.com/workspaces/latest/adminguide/workspaces-eol.html).


| Release | Date | Changes | 
| --- | --- | --- | 
| 5.31.0 | January 21, 2026 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.30.0 | October 21, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.29.2 | August 26, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.29.1 | August 5, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.29.0 | July 31, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.28.0 | July 1, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.27.1 | May 5, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.27.0 | April 30, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.26.2 | April 1, 2025 | Bug fixes and enhancements. | 
| 5.26.1  | March 11, 2025 | Bug fixes and enhancements. | 
| 5.26.0 | March 4, 2025 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.25.0 | December 19, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.24.1 | November 22, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.23.0 | September 30, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.22.1 | September 3, 2024 |  Bug fixes and enhancements.  | 
| 5.22.0 | August 16, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.21.0 | July 3, 2024 |  Bug fixes and enhancements.  | 
| 5.20.0 | June 13, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.19.3 | April 30, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.19.0 | February 28, 2024 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.18.0 | January 22, 2024 |  Updated DCV SDK.  | 
| 5.17.0 | November 16, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.16.0 | October 26, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.15.1 | September 20, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.13.0 | August 29, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.12.1 | August 16, 2023 |  Bug fixes and enhancements  | 
| 5.12.0 | July 11, 2023 |  Bug fixes and enhancements  | 
| 5.11.0 | July 3, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.10.0 | June 19, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.9.0 | May 9, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.8.0 | April 6, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.7.0 | February 23, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.6.4 | February 1, 2023 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.6.2 | January 18, 2023 | Bug fixes and enhancements | 
| 5.6.0 | December 27, 2022 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.5.0 | November 14, 2022 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.4.0 | October 5, 2022 |   Added support for automatic diagnostic log uploads feature that allows you to upload WorkSpaces client log files directly to WorkSpaces to troubleshoot issues without interrupting use of the WorkSpaces client.   | 
| 5.3.0 | September 15, 2022 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 5.2.1 | August 24, 2022 |  Fixed the WorkSpaces login page rendering issues on Windows 8.1  | 
| 5.2.0 | August 2, 2022 |  Updated PCoIP SDK for the WorkSpaces Windows client  | 
| 5.1.0 | June 30, 2022 |  Updated DCV SDK for Windows  | 
| 5.0.0 | June 2, 2022 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 4.0.6 | December 21, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 4.0.5 | November 23, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 4.0.4 | November 3, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 4.0.3 | October 4, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 4.0.2 | September 1, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 4.0.1 | July 30, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 4.0.0 | June 30, 2021 | The first 64-bit release of the Windows client application | 
| 3.1.10 | August 5, 2021 | Minor bug fixes and enhancements | 
| 3.1.9 | June 29, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.1.8 | May 28, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.1.7 | April 29, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.1.6 | April 8, 2021 |  Fixes for disconnects and crashes resulting from DCV audio traffic optimization  | 
| 3.1.5 | April 2, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.1.4 | March 16, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.1.3 | February 15, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.1.2 | January 8, 2021 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.1.1 | December 1, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  Version 3.1.1 is available only in the AWS GovCloud (US-West) Region   | 
| 3.1.0 | December 1, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.0.12 | November 10, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.0.11 | October 02, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.0.10 | September 16, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
| 3.0.9 | August 14, 2020 |  Minor bug fixes and enhancements  | 
| 3.0.8 | July 30, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  3.0.7  | June 3, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  3.0.6  | April 28, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  3.0.5  | March 30, 2020 |  Resolves an issue with the user interface displaying a login prompt if single sign-on (SSO) is enabled for Amazon WorkDocs  | 
|  3.0.4  | March 3, 2020 |  Minor bug fixes and enhancements  | 
|  3.0.2  | February 14, 2020 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  3.0.0  | November 25, 2019 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.5.11  | November 4, 2019 |  Minor bug fixes  | 
|  2.5.10  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.5.9  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.5.8  |  |  Resolves an intermittent crashing issue related to computer waking up when opening a laptop lid  | 
|  2.5.7  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.5.6  |  |  Minor fixes  | 
|  2.5.5  |  |  Minor fixes  | 
|  2.5.2  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.5.1  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.5.0  |  |  Adds support for user self-service WorkSpace management capabilities  | 
|  2.4.10  |  |  Minor fixes  | 
|  2.4.9  |  |  Minor fixes  | 
|  2.4.8  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.4.7  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.4.6  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.4.5  |  |  Adds a check to ensure that certificates issued by Amazon Trust Services are trusted by Windows during installation. By default, an up-to-date Windows local Root CA list includes Starfield Service Root Certificate Authority - G2, and therefore trusts Amazon Trust Services certificates. If the local Root CA list is outdated, the client installer installs the Starfield Service Root Certificate Authority - G2 certificate to the system. If you do not have administrator access to the client device, you'll be prompted to confirm the installation of the Root CA certificate.  | 
|  2.4.4  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.4.2  |  |  Minor fixes  | 
|  2.4.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.3.7  |  |  Addresses a gray screen issue that occurs when displays are in different orientations  | 
|  2.3.6  |  |  Localization enhancements  | 
|  2.3.5  |  |  Minor improvements  | 
|  2.3.3  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.3.2  |  |  Installer fixes  | 
|  2.3.1  |  |  Minor fixes  | 
|  2.3.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.2.3  |  |  Resolves minor bugs and improves stability  | 
|  2.2.1  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.1.3  |  |  Closing the client expires the reconnect token. You can easily reconnect to your WorkSpace as long as the client is running.  | 
|  2.1.1  |  |  Minor improvement to protocol handling  | 
|  2.1.0  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.0.8  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  2.0.6  |  |  Resolves bugs and includes other improvements  | 
|  2.0.4  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  1.1.80  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  1.1.6  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  1.1.4  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  1.0.8  |  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html)  | 
|  1.0  |  |  Initial release  |