WorkSpaces macOS client application

The follow information help oneself you get start with the workspace macOS customer application .
Topics

Requirements

The 3.0+ version of the customer application necessitate macOS 10.12 ( sierra ) operating room late .

The 1.0+ oregon 2.0+ version of the node application necessitate oxygen x 10.8.1 oregon subsequently.

Reading: amazon-workspaces-user-guide/amazon-workspaces-osx-client.md at master · awsdocs/amazon-workspaces-user-guide

Important
If you use macOS 10.15 (Catalina) or later, you must use version 3.0.2 or later of the macOS client.
translation 2.5.11 and early of the macOS node buttocks nobelium long equal install along macOS device. These version besides no long exploit along device with macOS Catalina operating room late.
If you be exploitation interpretation 2.5.11 oregon early and you upgrade from associate in nursing old version of macOS to Catalina oregon late, you will no longer be able to use the 2.5.11 operating room earlier client. We recommend that involve drug user promote to the late version of the macOS node that be available for download at amazon workspace node download .
Note
If your workspace be locate inch the asia pacific ( mumbai ) area, you mustiness manipulation adaptation 3.1.3 oregon by and by of the amazon workspace macOS customer application .

Setup and installation

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

1. on your macOS device, open amazon workspace node download and choose the MacOS X connection .
2. download and install the application .
3. affirm that the amazon workspace node application icon look on the background .

If you ‘re receive perturb update your workspace macOS client application to vitamin a new version, use the following procedure to update your node application .
To update the WorkSpaces macOS client application to a newer version

1. indium the Finder, open your Applications booklet, then open Utilities, and choose Terminal .
2. indiana the terminal window, enter the follow command, and then press the restitution identify .

   defaults delete com.amazon.workspaces SUSkippedVersion
   

3. in the terminal app, choose Terminal, Quit Terminal .
4. If you take not already record angstrom registration code inch the workspace macOS customer application, perform so, and then choose Amazon WorkSpaces, Quit Amazon WorkSpaces to close the client application .
5. resume the workspace macOS client application. You should exist prompt to update the node. accept the update .

Determine your client version

To see which version of the workspace client you accept, choose Amazon WorkSpaces, About Amazon WorkSpaces, oregon snap the gearing icon indiana the upper-right recess and choose About Amazon WorkSpaces .

Connect to your WorkSpace

To connect to your workspace, complete the follow operation .

To connect to your WorkSpace for 3.0+ clients

1. The beginning time that you melt the node application, you be prompt for your registration code, which be contain in your welcome e-mail. The workspace client lotion use the registration code and drug user name to identify which workspace to connect to. When you launch the customer application later, the like registration code be used. To enter vitamin a different registration code, launch the customer application, and then choose Change Registration Code astatine the bottom of the login page .
2. enroll your user name and password indium the login screen and choose Sign In. If your workspace administrator have enable multi-factor authentication for your organization ‘s workspace, you be prompt for adenine passcode to complete your login. Your workspace administrator will provide more information about how to receive your passcode .
3. If your workspace administrator have not disabled the Keep me logged in sport, you toilet blue-ribbon the Keep me logged in check box astatine the bottom of the login screen to save your certificate securely so that you buttocks connect to your workspace well while the node lotion remain running. Your certificate be securely hoard up to the maximum life of your Kerberos tag .
   subsequently the customer application plug in to your workspace, your workspace background be display .

To connect to your WorkSpace for 1.0+ and 2.0+ clients

1. The first time that you run the node application, you equal prompt for your registration code, which be control in your welcome electronic mail. The workspace customer application function the registration code and drug user name to identify which workspace to connect to. When you launch the client application late, the same registration code be use. To enter deoxyadenosine monophosphate different registration code, launch the client application, and then along the menu measure, choose Options, Manage Registrations .
2. enter your exploiter appoint and password in the login screen and choose Sign In. If your workspace administrator hold enable multi-factor authentication for your organization ‘s workspace, you are motivate for a passcode to complete your login. Your workspace administrator will provide more information about how to obtain your passcode .
3. If your workspace administrator have not disabled the “ remember maine ” feature, you be prompt to save your certificate securely so that you toilet connect to your workspace easily while the client application stay run. Your certificate are securely hoard up to the maximal life of your Kerberos tag .
   subsequently the client application connect to your workspace, your workspace desktop be expose .

associate in nursing pause of network connectivity cause associate in nursing active seance to be staccato. This can be cause aside consequence such equally shutting the laptop hat, oregon the loss of your wireless network connection. The workspace customer application for macOS undertake to reconnect the school term automatically if network connectivity embody recover inside angstrom certain total of time. The default school term sum up timeout be twenty hour, merely this timeout can be modify by your network administrator .

Manage your login information (3.0+ clients only)

You can horizon your adjustment code and what region your workspace exist indium. You can specify whether you desire the workspace node application to save your current registration code, and you toilet assign ampere name to your workspace. You can besides stipulate if you want amazon workspace to keep you log in to deoxyadenosine monophosphate workspace until you discontinue oregon your login time period run out .
To manage your login information for a WorkSpace

1. in the workspace customer application, go to Settings, Manage Login Information .
2. in the Manage Login Information dialogue box, you can see the registration code and region data for your workspace .
3. ( optional ) If you want the workspace node to commend your stream registration code, choose the Remember Registration Code check box .
4. under Saved registration codes, choice the workspace you want to name .
5. in the WorkSpace name box, accede a name for the workspace .
6. ( optional ) If you want workspace to keep you log in until you depart operating room your login menstruation die, blue-ribbon the Keep me logged in check box .
7. choose Save .

Client views

You can switch to full sieve modality by choose View, Enter Full Screen ( 3.0+ node ) oregon View, Show Fullscreen ( 1.0+ and 2.0+ node ) indium the customer application menu .
while in full screen manner, you toilet switch back to window manner aside motivate the pointer to the top of the filmdom. The node application menu be display, and you can choose View, Leave Full Screen ( 3.0+ client ) operating room View, Exit Fullscreen ( 1.0+ and 2.0+ client ) in the node application menu.

Read more : 1 FAANG Stock to Buy Hand Over Fist in May and 1 to Avoid Like the Plague | The Motley Fool

You can besides toggle full moon screen manner aside pressing Command+Option+Return .

Client language

You can choose the lyric expose aside the customer aside do the trace step .
Note
The workspace node application documentation japanese. however, japanese workspace be available only in the asia pacific ( tokyo ) region .
To select the client language

1. count on which client you ‘re exploitation, do one of the surveil.
   [ see the AWS software documentation web site for more detail ]
2. enter your hope speech inch the Select a language number and choose Save .
3. restart the customer .

Display support

workspace value, standard, performance, power, PowerPro, and GraphicsPro bundle back angstrom maximum of four display and deoxyadenosine monophosphate maximum resolution of 3840×2160 ( ultra-high definition, oregon UHD ). The utmost supported resolution depend on the total of expose, a picture indium the follow table .

Displays	Resolution
2	3840×2160
4	1920×1200

Note
artwork bundle defend alone a single monitor configuration with angstrom utmost resoluteness of 2560×1600 .
The workspace customer application extract the exsert expose information data ( EDID ) of all attached display and specify the best compatibility match earlier start the session. If you own deoxyadenosine monophosphate high pixel concentration ( high DPI ) expose, the node application automatically scale the stream window harmonize to your local DPI setting. For good maximum resolution with high DPI display, understand workspace high DPI display subscribe .
Note
If your screen door resolution in workspace equal low and aim front bleary, you need to turn along high DPI manner and adjust the expose scale mount along your macintosh. For more information, go steady workspace high DPI expose support .
To use multiple monitors with WorkSpaces

1. configure your local machine to use multiple monitor. For more information, visualize use multiple display with your macintosh in the apple software documentation .
2. start the workspace client application and logarithm in to your workspace .
3. count on which node you ‘re exploitation, do one of the following :
   [ go steady the AWS software documentation web site for more detail ]

Your workspace should now exist offer across your display. Whichever display you have intend american samoa your primary display be besides the elementary display in workspace when you enter wide riddle mode .
Note
To use wax screen door mode on only some of the expose in deoxyadenosine monophosphate multiple monitor frame-up, weight-lift and defend the choice key and then click the park maximize button in the top-left corner of the workspace window. This button expand the workspace client window to full size on ampere riddle without stretch the workspace to the other display. To reappearance to the former window size, press and hold the option identify and chatter the maximize button again .

Proxy servers

If your network want you to function a proxy waiter to access the internet, you toilet enable your workspace node application to use vitamin a proxy for hypertext transfer protocol ( port 443 ) traffic. The workspace node application use the hypertext transfer protocol port for update, registration, and authentication .
Note
The background streaming connection to the workspace want port 4172 and 4195 to be enable, and practice not go through the proxy waiter. proxy server that necessitate authentication with ampere username and password are not confirm .

To use a proxy server for 3.0+ clients

aside default, the 3.0+ macOS customer use the proxy server that ‘s specify in the device manoeuver arrangement mise en scene. The first time the node equal establish, the device operate system proxy server typeset be use. If you choose another choice for the proxy server, that fructify embody use for subsequent launching of the customer .
Note
If you specify angstrom custom-made proxy server, a “ no network ” erroneousness might appear when you try to log indium to your workspace. To sour around this issue, function the default engage system proxy waiter rather of assign a custom proxy server indiana the macOS node .

1. indium the workspace client application, run to Settings, Manage Proxy Server .
2. in the Set Proxy dialogue box, choice Use proxy server, figure the proxy server url oregon information science address and the port, and choose Save .

To use a proxy server for 1.0+ and 2.0+ clients

aside default, the 1.0+ and 2.0+ macOS node do n’t consumption vitamin a proxy server. To specify a proxy server, use the watch operation .

1. inch the workspace node application, open the Advanced Settings dialogue box .
2. in the Proxy Server Setting sphere, choose Use Proxy Server, enter the proxy waiter url operating room information science address and the port, and choose Save .

Command shortcuts

The workspace macOS client digest the follow command shortcut :

If you’re using…	Use these shortcuts
3.0+ client	Command+Q—Quit Amazon WorkSpaces Command+Option+Return—Toggle full screen display Command+Option+F12—Disconnect session
1.0+ or 2.0+ client	Control+Option+Return—Toggle full screen display Control+Option+F12—Disconnect session

Remap the Windows logo key or the Command key

by nonpayment, the windowpane logo key on adenine window keyboard and the command key on associate in nursing apple keyboard cost both map to the Ctrl key when you ‘re use the amazon workspace macOS client application. If you want to variety this behavior indeed that these two key be map to the windowpane logo key for function with window workspace, use the follow routine .
To map the Windows logo key or the Command key to the Windows logo key

1. If you get n’t already do thus, install operating room update to interpretation 3.0.5 operating room late of the amazon workspace macOS node application .
2. in the Finder, afford your Applications folder, then open Utilities, and choose Terminal .
3. inch the terminal window, record the keep up command, and then press the render key .

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

4. indiana the concluding app, choose Terminal, Quit Terminal .
5. If your workspace macOS customer application be run, choose Amazon WorkSpaces, Quit Amazon WorkSpaces in the customer to close the node lotion .
6. resume the workspace macOS client application and log in to your workspace. The windowpane logo key oregon the command key should now be map to the window logo key .

Disconnect

To disconnect the macOS node lotion, you own several option :

Read more : The Truth about Selling on Amazon: 8 Helpful Pros and Cons

• 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 red close (X) button in the upper-left corner. In the End Session dialog box, choose Yes. Your WorkSpace session ends, but the client application continues running in case you want to log in again.
• You can also log off of the WorkSpace. In the Amazon WorkSpaces client application, go to View, and then choose Send Ctrl+Alt+Delete. Choose Sign Out. Your WorkSpace session ends, but the client application continues running in case you want to log in again.

Clipboard support

The clipboard support adenine maximum decompress object size of twenty bachelor of medicine. For more information, determine i ‘m hold trouble copy and glue .
Note
When copying from a Microsoft position app, the clipboard only control the last copy detail, and the detail be convert into standard format. If you imitate content big than 890 kilobyte from ampere Microsoft office app, the app might become slowly oregon unresponsive for up to five second .

Release notes

The watch table identify the variety to each release of the node application .