How do I troubleshoot keyboard issues in Amazon WorkSpaces?

Resolution

Troubleshoot keyboard issues for all operating systems

Take the following actions:

• Use the keyboard with a local machine to determine whether there's an issue with the keyboard hardware.
• Verify that you have the latest WorkSpaces client.
• Reboot the WorkSpace from the WorkSpaces console.
• Turn off secure keyboard features in your antivirus software settings.
  Note: Review the documentation for your antivirus software for instructions.
• Turn off custom key remapping applications.
• If you use an international keyboard, then verify that the keyboard layout on the WorkSpace and the client match. For Windows, see Manage the input and display language settings in Windows 10 on the Microsoft website. For macOS, see Type in another language on your Mac with input sources on the Apple website.

If your keyboard still doesn't respond, then complete the following steps:

1. Open the Keyboard Event Viewer in a web browser. See the Keyboard Event Viewer on the GitHub website.
2. Test each key of your keyboard. After you finished, leave the window open.
3. Log in to your WorkSpace.
4. Open the Keyboard Event Viewer in your WorkSpace.
5. Test each key of your keyboard.
6. Compare the key code in your WorkSpace to the key code in your web browser.

If the key codes are different, then you can change the keyboard layout so that both versions match. For more information, see Language and keyboard settings for WorkSpaces.

Turn off Secure Keyboard Entry for macOS

When you activate the Secure Keyboard Entry option on macOS, the WorkSpaces client can't receive input from the operating system (OS).

To turn off Secure Keyboard Entry on macOS, complete the following steps:

1. Open a Terminal window.
2. On the menu bar, choose Terminal, then clear Secure Keyboard Entry.

If the none of the preceding troubleshooting steps resolves your issue, then contact AWS Support.

Related information

WorkSpaces Windows client application

WorkSpaces Linux client application

WorkSpaces macOS client application