Menu
Amazon AppStream
Developer Guide

This documentation is for an older version of Amazon AppStream. For information about the latest version, see the Amazon AppStream 2.0 Developer Guide.

Streaming Your Application Using Amazon AppStream Standalone Mode

Testing your application using Amazon AppStream standalone mode provides a way to test that streaming works without having the overhead of a full deployment to Amazon AppStream. It also gives you a way to test your application without having to write an entitlement service or a custom client by using a AWS CloudFormation template to create your own Amazon EC2 instance with the Amazon AppStream SDK libraries installed.

You may incur charges when you use Amazon AppStream standalone mode. In standalone mode, you are using your own EC2 instance rather than Amazon AppStream. Using standalone mode does not apply to the first 20 hours of streaming from Amazon AppStream.

Note

Do not use a standalone streaming server to deploy your streaming application for client access. Doing so will prevent you from taking advantage of the session management and automatic scaling provided by Amazon AppStream.

To use the AWS CloudFormation template described below, you must have:

  • An active AWS account. You will need the access keys for the account or for an IAM user in the account. If you are using the access keys of an IAM user, that user must have permissions to perform Amazon AppStream actions. For more information, see AWS Security Credentials.

  • An EC2 key pair. You can use this to connect to the instance that hosts the entitlement service with SSH. For more information, see Amazon EC2 Key Pairs.

To create the Amazon AppStream standalone mode

  1. Sign in to the AWS Management Console and open the Amazon AppStream console at https://console.aws.amazon.com/appstream/.

  2. From the navigation bar, select the same region where you created a new key pair or are using an existing key pair.

    Important

    Do not select a region other than the one where your key pair was created.

  3. In the AWS CloudFormation console, select Create New Stack.

  4. For Name, type a name to identify the stack. For example, StandaloneStack.

  5. Select Specify an Amazon S3 template URL and then enter https://s3.amazonaws.com/appstream-public/AppStreamDeveloper.template and then click Next.

  6. In Specify Parameters, do the following:

    • For DeveloperPassword, type a password that is between 12-20 characters that meets the following requirements:

      • Contains at least 2 numbers

      • Contains two lower case and two upper case letters

      • Contains two special characters (@, #, $, %, ^, &, +, or =)

      • Does not contain spaces

    • For KeyPairName, type the name of your existing key pair in the same region.

    • For MicrosoftVirtualAudioDrivers, type Yes.

    • For NvidiaGRIDDrivers, type Yes.

    • For TightVNC, type Yes.

    • For TightVNC, type an eight character password that meets the following requirements:

      • Must be a different password from the password used for DeveloperPassword.

      • Contain one number, one letter, one special character.

      • Contain one special characters (@, #, $ %, ^, &, +, or =)

      • Must not contain any spaces.

    • Click Next.

  7. In Options, do the following:

    • For Key, type Name.

    • For Value, type the name that you created earlier.

    • Click Next.

  8. In Review, check that the parameters you entered are correct and then click Create.

When the status of your stack changes to CREATE_COMPLETE, the Amazon AppStream standalone mode is deployed and ready to use. You can view the properties of your new server in the Amazon EC2 console.

To find the IP Address of your standalone host

  1. In the AWS CloudFormation console, click on the name of your standalone host to display details about the stack at the bottom of the browser window.

  2. In the details pane, click Outputs. This displays the following values:

    Key Description
    InstanceId The identifier of the EC2 instance. You can use this value to locate the standalone host in the EC2 console.
    PublicIp The public IP address of the EC2 instance. You can use this value to connect the sample clients to your application without using an entitlement service.
    PublicDnsName The public DNS name of the EC2 instance.