Manage your WorkSpace from your client - Amazon WorkSpaces
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Manage your WorkSpace from your client

If you use the Windows client , the macOS client , or the Linux client for WorkSpaces, you can perform the following management tasks directly from your client.

Note

You can perform these tasks only if they are enabled by your WorkSpaces administrator.

Save your credentials

You can choose whether to save your sign-in credentials securely so that you can reconnect to your WorkSpace without re-entering your credentials while the client application remains running. Your credentials are securely cached in RAM only. You can disable this feature and enable it again at any time.

  1. Open your WorkSpaces client.

  2. On the client login screen, select or clear the Keep me logged in check box to enable or disable this option as required.

  1. Open your WorkSpaces client.

  2. On the client login screen, choose the gear icon (Windows) or the Option menu (macOS), and choose Advanced Settings.

  3. Select or clear the Remember Me check box to enable or disable this option as required.

Change your password

You can change your WorkSpaces login password at any time.

To change your password
  1. Open your WorkSpaces client.

  2. On the client login screen, choose Forgot Password? under the Sign In button.

    Note

    If Forgot password? isn't available on your login screen, contact your WorkSpaces administrator for assistance with resetting your password.

    Forgot Password? is not available in the Amazon GovCloud (US-West) Region.

  3. Enter your user name, and then enter the characters you see in the image.

  4. Choose Recover Password.

  5. You will receive an email with a password-reset link. Follow the instructions in the email to change your password. Passwords are case-sensitive and must be between 8 and 64 characters in length, inclusive. Passwords must contain at least one character from each of the following categories:

    • Lowercase characters (a-z)

    • Uppercase characters (A-Z)

    • Numbers (0-9)

    • Non-alphanumeric characters (~!@#$%^&*_-+=`|\(){}[]:;"'<>,.?/)

    Ensure you don't include non-printable unicode characters, such as white spaces, carriage reture tabs, line breaks, and null characters.

    Note

    If you receive an error, contact your Amazon Managed Microsoft AD administrator.

Restart your WorkSpace

If you are experiencing issues with your WorkSpace, you can restart (reboot) it. Restarting a WorkSpace disconnects you from your WorkSpace, so that it can be shut down and restarted. Your user data, operating system, and system settings are not affected. This process takes several minutes to finish.

Important

To avoid losing changes, save any open documents and other application files before you restart your WorkSpace.

To restart your WorkSpace
  1. Open your WorkSpaces client and connect to your WorkSpace.

  2. Choose WorkSpaces, Restart WorkSpace.

  3. When prompted to restart your WorkSpace, choose Restart.

  4. After you are disconnected from your WorkSpace, the client application login screen remains open. You can log back in to your WorkSpace, or close the screen.

Increase your the size of WorkSpace disks

You can increase your WorkSpace disk size to add more storage capacity. You can increase the size of your C: drive (for Linux, this is /) up to 175 GB, and you can increase the size of your D: drive (for Linux, this is /home) up to 100 GB without contacting your administrator. If you need your drives increased beyond these limits, your administrator must increase the sizes of your drives for you.

If your administrator recently created your WorkSpace, you must wait 6 hours before you can increase your WorkSpace disk sizes. After that, you can increase your disk sizes once in a 6-hour period.

You cannot increase the size of the C: and D: drives at the same time. (The same is true of the / and /home volumes in Linux.) To increase the C: drive (or / in Linux), you must first increase the D: drive (or /home in Linux) to 100 GB. After the D: drive (or /home in Linux) has been increased, you can increase the C: drive (or / in Linux).

While your WorkSpace disk size increase is in progress, you can perform most tasks on your WorkSpace. However, you can't change your WorkSpace compute type, switch the WorkSpace running mode, rebuild your WorkSpace, or restart your WorkSpace. The disk size increase process might take up to an hour.

Important
  • You can resize only SSD volumes.

  • Increasing your WorkSpace disk size will increase the amount that your organization pays for your WorkSpace.

To increase your WorkSpace disk size
  1. Open your WorkSpaces client and connect to your WorkSpace.

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

    If you're using... Do this

    3.0+ client

    Choose Settings, Increase Disk Size.

    1.0+ or 2.0+ client

    Choose My WorkSpace, Increase disk size.

  3. The Increase disk size dialog box displays the current disk size of your C: drive and D: drive (or / and /home in Linux). If you proceed with the disk size increase, it also displays the amount by which your storage increases.

  4. To proceed with the disk size increase, choose Increase.

  5. A message displays information about the disk size increase process. Review the information, and choose Close.

  6. When the disk size increase is finished, you must restart the WorkSpace for the changes to take effect. Save any open files before restarting the WorkSpace.

Change your WorkSpace compute type

You can change your WorkSpace compute type to choose a different bundle for your WorkSpace. If your administrator recently created your WorkSpace, you must wait 6 hours before you can change your WorkSpace compute type. After that, you can switch to a larger compute type once in a 6-hour period, or to a smaller compute type once in a 30-day period.

When your WorkSpace compute type change is in progress, you are disconnected from the WorkSpace. During this time, you can't use or make changes to the WorkSpace. This process might take up to an hour.

Important
  • To avoid losing changes, save any open documents and other application files before you change your WorkSpace compute type.

  • Changing your WorkSpace compute type will change the amount that your organization pays for your WorkSpace.

To change your WorkSpace compute type
  1. Open your WorkSpaces client and connect to your WorkSpace.

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

    If you're using... Do this

    3.0+ client

    Choose Settings, Change Compute Type.

    1.0+ or 2.0+ client

    Choose My WorkSpace, Change compute type.

  3. The Change compute type dialog box displays the current compute type for your WorkSpace. Choose a different compute type from the list, and then choose Update.

  4. A message displays information about the compute type change process. Review the information, and choose Update.

Switch the WorkSpace running mode

You can specify whether your WorkSpace is always running or whether it stops after a specified period of inactivity. WorkSpaces provides the following two running modes that you can choose from.

  • AlwaysOn — Keeps your WorkSpace always running.

  • AutoStop — Your WorkSpace starts when you sign in and stops after a specified period of inactivity. After your WorkSpace stops, the state of your apps and data is saved.

Note

Switching your WorkSpace running mode will change the amount that your organization pays for your WorkSpace.

  1. Open your WorkSpaces client and connect to your WorkSpace.

  2. Choose Settings, Switch Running Mode.

  3. In the Switch Running Mode dialog box, choose a different running mode, and then choose Switch.

  4. A message confirms your choice. Close the message box.

  1. Open your WorkSpaces client and connect to your WorkSpace.

  2. Choose My WorkSpace, Switch running mode.

  3. In the Switch running mode dialog box, choose a different running mode, and then choose Switch.

  4. A message confirms your choice. Choose Close.

Rebuild your WorkSpace

To restore the operating system that is running on your WorkSpace to its original state, you can rebuild the WorkSpace.

If you want to rebuild your WorkSpace to resolve an issue that you are experiencing with the WorkSpace, try restarting it first. If you rebuild your WorkSpace, any applications that you installed and system settings that you configured after the WorkSpace was created are lost.

When a WorkSpace is rebuilt, the D: drive is re-created from the latest backup. Because backups are completed every 12 hours, your data might be up to 12 hours old. If your administrator recently created your WorkSpace, you must wait 12 hours before you can rebuild your WorkSpace.

Important

To avoid losing any data, save any open documents and other application files before you rebuild your WorkSpace, and then contact your WorkSpaces administrator to make sure your D: drive has been backed up.

While your WorkSpace rebuild is in progress, you are disconnected from the WorkSpace. During this time, you can't use or make changes to the WorkSpace. The rebuild process might take up to an hour.

To rebuild your WorkSpace
  1. Open your WorkSpaces client and connect to your WorkSpace.

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

    If you're using... Do this

    3.0+ client

    Choose Settings, Rebuild WorkSpace.

    1.0+ or 2.0+ client

    Choose My WorkSpace, Rebuild WorkSpace.

  3. In the Rebuild WorkSpace dialog box, review the information. If you choose to proceed with the rebuild, choose Rebuild.