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.

Using Environment Variables

Environment variables override configuration settings and can be useful for scripting or temporarily setting a condition as the default.

The following variable is supported by Amazon AppStream.

VDI_CAPTUREMOUSECURSOR – When set to true, Amazon AppStream displays the remote mouse pointer of the streaming application. By default, this variable is false, which disables the remote mouse pointer. For more information, see Displaying Mouse Pointers.

To set an environment variable

You set an environment variable as part of deploying a streaming application.

  1. Sign in to the AWS Management Console and open the Amazon AppStream console at

  2. Click Deploy an application.

  3. In Set up your application, do the following:

    • For Application name, type the name of your streaming application. This text identifies your streaming application in the console.

    • For Application description, type a short description of the streaming application. This text appears in the application summary page.

    • Select Required Components.

    • Click Open Windows & install your application to display the Windows live host desktop.

  4. In the live Windows host desktop, click Computer.

  5. Navigate to the C:\Windows\System32 folder.

  6. Click cmd.exe.

  7. In the command prompt, type setx <environment variable> where <environment variable> is the environment variable and setting. For example, type the following to configure Amazon AppStream to use the remote mouse pointer:


  8. Press Enter.

  9. Type exit and press Enter to close the command prompt.

  10. Continue with the deployment.