The following information helps you get started with the WorkSpaces macOS client application. Show
Contents
RequirementsThe 3.0+ versions of the client application require macOS 10.12 (Sierra) or later. The 1.0+ or 2.0+ versions of the client application require OS X 10.8.1 or later. If you use macOS 10.15 (Catalina) or later, you must use version 3.0.2 or later of the macOS client. Versions 2.5.11 and earlier of the macOS client can no longer be installed on macOS devices. These versions also no longer work on devices with macOS Catalina or later. If you are using version 2.5.11 or earlier and you upgrade from an older version of macOS to Catalina or later, you will no longer be able to use the 2.5.11 or earlier client. We recommend that affected users upgrade to the latest version of the macOS client that is available for download at Amazon WorkSpaces Client Downloads.
Setup and installationTo download and install the client application, complete the following procedure. To download and install the client application
If you're having trouble updating your WorkSpaces macOS client application to a newer version, use the following procedure to update your client application. To update the WorkSpaces macOS client application to a newer version
Determine your client versionTo 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 WorkSpaceTo connect to your WorkSpace, complete the following procedure.
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+ clients only)You can view your registration code and what Region your WorkSpace is in. You can specify whether you want the WorkSpaces client application to save your current registration code, and you can assign a name to your WorkSpace. You can also specify if you want Amazon WorkSpaces to keep you logged in to a WorkSpace until you quit or your login period expires. To manage your login information for a WorkSpace
Client viewsYou can switch to full screen mode by choosing View, Enter Full Screen (3.0+ clients) or View, Show Fullscreen (1.0+ and 2.0+ 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+ clients) or View, Exit Fullscreen (1.0+ and 2.0+ clients) in the client application menu. You can also toggle full screen mode by pressing Command+Option+Return. Client languageYou can select the language displayed by the client by performing the following steps. The WorkSpaces client applications support Japanese. However, Japanese WorkSpaces are available only in the Asia Pacific (Tokyo) Region. To select the client language
Display supportWorkSpaces Value, Standard, Performance, Power, PowerPro, and GraphicsPro bundles support a maximum of four displays and a maximum resolution of 3840x2160 (ultra-high definition, or UHD). The maximum supported resolution depends on the number of displays, as shown in the following table.
Graphics bundles support only a single monitor configuration with a maximum resolution of 2560x1600. The WorkSpaces client application extracts the Extended Display Information Data (EDID) of all attached displays and determines the best compatibility match before starting the session. If you have a high pixel density (high DPI) display, the client application automatically scales the streaming window according to your local DPI settings. For better maximum resolution with high DPI displays, see WorkSpaces high DPI display support. 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 WorkSpaces high DPI display support. To use multiple monitors with WorkSpaces
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. 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 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 serversIf 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.
By default, the 3.0+ 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. 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.
By default, the 1.0+ and 2.0+ macOS clients don't use a proxy server. To specify a proxy server, use the following procedure.
Command shortcutsThe WorkSpaces macOS client supports the following command shortcuts:
Remap the Windows logo key or the Command keyBy 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
DisconnectTo disconnect the macOS client application, you have several options:
Clipboard supportThe clipboard supports a maximum uncompressed object size of 20 MB. For more information, see I'm having trouble copying and pasting. 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 notesThe following table describes the changes to each release of the client application.
How do I find my OS version on Mac terminal?How to find out macOS version information from Terminal command prompt. system_profiler command – Show Apple hardware and software configuration.. sw_vers command – Show Mac OS X operating system version.. uname command – Show operating system name and more.. What is the current macOS 2022?The successor to macOS Big Sur, it was announced at WWDC 2021 on June 7, 2021, and released on October 25, 2021. macOS Monterey was succeeded by macOS Ventura, which was released on October 24, 2022.
How do I check if my Mac is compatible?How to check your Mac's software compatibility. Head to Apple's support page for the macOS Mojave compatibility details.. If your machine can't run Mojave, check compatibility for High Sierra.. If it's too old to run High Sierra, try Sierra.. If no luck there, give El Capitan a try for Macs a decade old or more.. |