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.

Debugging Your Streaming Application in Amazon AppStream Standalone Mode

You can debug your streaming application in Amazon AppStream standalone mode by installing the Remote Tools for Visual Studio on your Amazon EC2 instance. Remote Tools for Visual Studio allows you to debug your streaming application on the EC2 instance from another computer running Visual Studio.

To install Remote Tools for Visual Studio

  1. From your computer, start Remote Desktop Connection (RDC) and connect to the EC2 instance. For more information, see Connecting to Your Windows Instance in the Amazon Elastic Compute Cloud Microsoft Windows Guide.

  2. From the EC2 instance, download and install the version of Remote Tools for Visual Studio that matches the version of Visual Studio on your computer.

  3. Restart the EC2 instance and connect to it using RDC.


    Restarting the EC2 instance may change its Public IP address.

To configure Remote Tools for Visual Studio

  1. From the Start menu of the EC2 instance, click Remote Debugger.

  2. From Visual Studio Remote Debugging Monitor, click Tools > Options.

  3. In the Options dialog box, do the following:

    1. For TCP/IP port number, type a port number of your choice. In this section, the port number is designated by N.

    2. For Authentication mode, select Windows Authentication.

    3. Click OK.

To configure your EC2 instance

In this procedure, you will configure the security group for your EC2 instance to accept inbound and outbound traffic from a specific TCP port. By limiting the traffic to a specific port during testing, you are reducing the chances of a malicious attack on your EC2 instance.

  1. From your computer, open the Amazon EC2 console at

  2. In the navigation pane, click Instances. Select your EC2 instance and click the link to the security group in the Description tab.

  3. In the details pane, on the Inbound tab, click Edit.

  4. In the dialog, click Add Rule, and then select Custom TCP Rule from the Type list. For Port Range, type the port number you entered in the earlier step. In the Source field, select Anywhere.

  5. Click Save.

To start debugging

  1. From your computer, start Visual Studio.

  2. From the Tools menu, click Attach to Process.

  3. In the Attach to Process dialog box, do the following:

    1. For Transport, select Default.

    2. For Qualifier, type the Public IP address of the EC2 instance using the form,


      • is the Public IP address of your EC2 instance.

      • N is the port number you specified in an earlier step.

    3. Select Show process from all users.

    4. In the Available Process list, select the process of your streaming application and then click Attach.