Amazon AppStream 2.0
Developer Guide

Enabling Application Settings Persistence

Prerequisites for Enabling Application Settings Persistence

To enable application settings persistence, you must first do the following:

Best Practices for Enabling Application Settings Persistence

To enable application settings persistence without providing internet access to your instances, use a VPC endpoint. This endpoint must be in the VPC to which your AppStream 2.0 instances are connected. You must attach a custom policy to enable AppStream 2.0 access to the endpoint. For information about how to create the custom policy, see the Home Folders and VPC Endpoints section in Networking, Access, and Security for Amazon AppStream 2.0. For more information about private Amazon S3 endpoints, see VPC Endpoints and Endpoints for Amazon S3 in the Amazon VPC User Guide.

How to Enable Application Settings Persistence

You can enable or disable application settings persistence while creating a stack or after the stack is created by using the AppStream 2.0 console, AppStream 2.0 API, an AWS SDK, or the AWS Command Line Interface (CLI). For each AWS Region, persistent application settings are stored in an S3 bucket in your account.

The first time you enable application settings persistence for a stack in an AWS Region, AppStream 2.0 creates an S3 bucket in your AWS account in the same Region. The same bucket stores the application settings VHD file for all users and all stacks in that AWS Region. For more information, see Amazon S3 Bucket Storage in Administer the VHDs for Your Users' Application Settings.

To enable application settings persistence while creating a stack

  • Follow the steps in Create a Stack, and make sure that Enable Application Settings Persistence is selected.

To enable application settings persistence for an existing stack

  1. Open the AppStream 2.0 console at https://console.aws.amazon.com/appstream2.

  2. In the left navigation pane, choose Stacks, and select the stack for which to enable application settings persistence.

  3. Below the stacks list, choose User Settings, Application Settings Persistence, Edit.

  4. In the Application Settings Persistence dialog box, choose Enable Application Settings Persistence.

  5. Confirm the current settings group or type the name of a new settings group. When you're done, choose Update.

New streaming sessions now have application settings persistence enabled.