Amazon WorkSpaces
Administration Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Get Started with Amazon WorkSpaces Quick Setup

In this tutorial, you'll learn how to provision a virtual, cloud-based Microsoft Windows or Amazon Linux desktop, known as a WorkSpace, by using Amazon WorkSpaces and AWS Directory Service.

This tutorial uses the Quick Setup option to launch your WorkSpace. This option is available only if you have never launched a WorkSpace. Alternatively, see Launch a Virtual Desktop Using Amazon WorkSpaces.

Note

Quick Setup is supported only in the following AWS Regions:

  • US East (N. Virginia)

  • US West (Oregon)

  • EU (Ireland)

  • Asia Pacific (Singapore)

  • Asia Pacific (Sydney)

  • Asia Pacific (Tokyo)

Before You Begin

  • You must have an AWS account to create or administer a WorkSpace. Users do not need an AWS account to connect to and use their WorkSpaces.

  • When you launch a WorkSpace, you must select a WorkSpace bundle. For more information, see Amazon WorkSpaces Bundles.

  • When you launch a WorkSpace, you must specify profile information for the user, including a user name and email address. Users complete their profiles by specifying a password. Information about WorkSpaces and users is stored in a directory.

  • Amazon WorkSpaces is not available in every Region. Verify the supported Regions and select a Region for your WorkSpaces. For more information about the supported Regions, see Amazon WorkSpaces Pricing by AWS Region.

Step 1: Launch the WorkSpace

Using Quick Setup, you can launch your first WorkSpace in minutes.

To launch a WorkSpace

  1. Open the Amazon WorkSpaces console at https://console.aws.amazon.com/workspaces/.

  2. Choose Get Started Now. If you don't see this button, either you have already launched a WorkSpace in this Region, or you aren't using one of the Regions that support Quick Setup.

  3. On the Get Started with Amazon WorkSpaces page, next to Quick Setup, choose Launch.

  4. For Bundles, select a bundle for the user.

  5. For Enter User Details, complete Username, First Name, Last Name, and Email.

  6. Choose Launch WorkSpaces.

  7. On the confirmation page, choose View the WorkSpaces Console. The initial status of the WorkSpace is PENDING. When the launch is complete, the status is AVAILABLE and an invitation is sent to the email address that you specified for the user.

Quick Setup

Quick Setup completes the following tasks on your behalf:

  • Creates an IAM role to allow the Amazon WorkSpaces service to create elastic network interfaces and list your Amazon WorkSpaces directories. This role has the name workspaces_DefaultRole.

  • Creates a virtual private cloud (VPC).

  • Sets up a Simple AD directory in the VPC that is used to store user and WorkSpace information. The directory has an administrator account and it is enabled for Amazon WorkDocs.

  • Creates the specified user accounts and adds them to the directory.

  • Creates WorkSpace instances. Each WorkSpace receives a public IP address to provide internet access. The running mode is AlwaysOn. For more information, see Manage the WorkSpace Running Mode.

  • Sends invitation emails to the specified users.

Note

The first user account created by Quick Setup is your Admin user account. You can't update this user account from the Amazon WorkSpaces Console. Don't share the information for this Admin account with anyone else. If you want to invite other users to use this WorkSpace, create new user accounts for them.

Step 2: Connect to the WorkSpace

After you receive the invitation email, you can connect to the WorkSpace using the client of your choice. After you sign in, the client displays the WorkSpace desktop.

Note

When you are connected to your WorkSpace from a Windows or MacOS client, you can toggle the full screen display by using following command shortcuts:

  • Windows client: Ctrl+Alt+Enter

  • MacOS client: Control+Option+Return

To connect to the WorkSpace

  1. If you haven't set up credentials for the user already, open the link in the invitation email and follow the directions. Remember the password that you specify as you will need it to connect to your WorkSpace.

    Note that passwords are case-sensitive and must be between 8 and 64 characters in length, inclusive. Passwords must contain at least one character from three of the following categories: lowercase letters (a-z), uppercase letters (A-Z), numbers (0-9), and the set ~!@#$%^&*_-+=`|\(){}[]:;"'<>,.?/.

  2. When prompted, download one of the client applications or launch Web Access. For more information about the requirements for each client, see Amazon WorkSpaces Clients in the Amazon WorkSpaces User Guide.

    If you aren't prompted and you haven't installed a client application already, open https://clients.amazonworkspaces.com and follow the directions.

  3. Start the client, enter the registration code from the invitation email, and choose Register.

  4. When prompted to sign in, enter the user name and password, and then choose Sign In.

  5. (Optional) When prompted to save your credentials, choose Yes.

Step 3: Clean Up (Optional)

If you are finished with the WorkSpace that you created for this tutorial, you can delete it.

To delete the WorkSpace

  1. Open the Amazon WorkSpaces console at https://console.aws.amazon.com/workspaces/.

  2. In the navigation pane, choose WorkSpaces.

  3. Select your WorkSpace and choose Actions, Remove WorkSpaces.

  4. When prompted for confirmation, choose Remove WorkSpaces.

  5. (Optional) If you are not using the directory with another application, such as Amazon WorkDocs, Amazon WorkMail, or Amazon Chime, you can delete it as follows:

    1. In the navigation pane, choose Directories.

    2. Select your directory and choose Actions, Deregister.

    3. Select your directory again and choose Actions, Delete.

    4. When prompted for confirmation, choose Delete.