Amazon AppStream 2.0
Developer Guide

Getting Started with Amazon AppStream 2.0

To stream your applications, Amazon AppStream 2.0 requires an environment consisting of a stack and at least one application image. This tutorial walks through the steps for putting together a sample AppStream 2.0 environment for application streaming and giving users access to that stream.

Step 1: Set Up a Sample Stack

Before you can stream your applications, you need to create a stack. In this step, you create a new stack from the sample stack template to simplify the creation.

To set up the AppStream 2.0 sample stack

  1. Open the AppStream 2.0 console at

  2. Choose Get Started if you are new to the console, or Quick Links from the left navigation menu. Choose Set up with sample apps.

  3. For Step 1: Stack Details, keep the default sample stack name and description, or type new ones, and then choose Next.

  4. For Step 2: Choose Image, choose an image, and then choose Next. The sample image contains pre-installed open source applications for evaluation purposes. For more information, see Amazon AppStream 2.0 Windows Image Version History.

  5. For Step 3: Configure Fleet, we recommend that you keep the default values and choose Next. You can change most of these values after fleet creation.

    • Choose instance type — Choose the instance type that matches the performance requirements of your applications. All streaming instances in your fleet launch with the instance type that you select. For more information, see AppStream 2.0 Instance Families.

    • Fleet type — Choose the fleet type that suits your use case. The fleet type determines its immediate availability and how you pay for it.

    • Disconnect timeout — Choose the time that a streaming instance should remain active after users disconnect. If users try to reconnect to the streaming session after a disconnection or network interruption within this time interval, they are connected to the previous session. Otherwise, they are connected to a new session with a new instance.

    • Minimum capacity — Choose a minimum number of instances for your fleet based on the minimum number of expected concurrent users. Every unique user session is served by an instance. For example, to have your stack support 100 concurrent users during low demand, specify a minimum capacity of 100. This ensures that 100 instances are running even if there are fewer than 100 users.

    • Maximum capacity — Choose a maximum number of instances for your fleet based on the maximum number of expected concurrent users. Every unique user session is served by an instance. For example, to have your stack support 500 concurrent users during high demand, specify a maximum capacity of 500. This ensures that up to 500 instances can be created on demand.

  6. For Step 4: Configure Network, choose a VPC and two subnets with access to the network resources that your application needs. If you don't have a VPC or subnets, you can create them using the links provided and then click the refresh icons. For Security groups, you can select up to five security groups. Otherwise, the default security group is used. For more information, see Network Settings for Fleet and Image Builder Instances.

  7. For Step 5: Enable Storage, keep the default setting, Enable Home Folders, and choose Review. Home Folders offer persistent storage for AppStream 2.0 streaming sessions. For more information, see Persistent Storage with AppStream 2.0 Home Folders.

  8. Choose Create.

    After the service sets up some resources, the Stacks page appears. The status of your new stack is Active when it is available to work with from the console. You cannot use the stack for streaming sessions until the status is Running.

Step 2: Provide Access to Users

After you create a stack, each user needs an active URL for access. The AppStream 2.0 User Pool feature enables you to create and manage users, using a permanent login portal URL. For more information, see Manage Access Using the AppStream 2.0 User Pool. To quickly test application streaming without setting up users, create a temporary URL as shown below.

To provide access to users with a temporary URL

  1. In the navigation pane, choose Stacks. Select the radio button for the stack, and then choose Actions, Create Streaming URL.

  2. For User id, type the user ID. Select an expiration time, which determines how long the generated URL is valid.

  3. To view the user ID and URL, choose Get URL.

  4. To copy the link to the clipboard, choose Copy Link.


For more information, see the following: