# Manage WorkSpaces Applications Agent Versions
<a name="base-images-agent"></a>

The WorkSpaces Applications agent is software that runs on your streaming instances and enables users to stream applications. When you create a new image, the **Always use latest agent version** option is selected by default. When this option is selected, new image builders or fleet instances that are launched from your image always use the latest WorkSpaces Applications agent version. You might want to control agent updates to ensure compatibility with your software or to qualify the updated environment before you deploy it for your end users.

The following procedures describe how to manage WorkSpaces Applications agent versions.

**Topics**
+ [

# Create an Image That Always Uses the Latest Version of the WorkSpaces Applications Agent
](create-image-that-always-uses-latest-agent.md)
+ [

# Create an Image That Uses a Specific Version of the WorkSpaces Applications Agent
](create-image-that-uses-specific-agent.md)
+ [

# Create an Image That Uses a Newer Version of the WorkSpaces Applications Agent
](create-image-that-uses-newer-agent.md)

# Create an Image That Always Uses the Latest Version of the WorkSpaces Applications Agent
<a name="create-image-that-always-uses-latest-agent"></a>

When your images are configured to always use the latest WorkSpaces Applications agent version, your streaming instances are automatically updated with the latest features, performance improvements, and security updates that are available from AWS when a new agent version is released.

**Note**  
In some cases, a new WorkSpaces Applications agent version might conflict with your software. We recommend that you qualify the new WorkSpaces Applications agent version before deploying it to your production fleets.

**To create an image that always uses the latest version of the WorkSpaces Applications agent**

1. Open the WorkSpaces Applications console at [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home).

1. Do either of the following: 
   + If you have an image builder that you want to use to create the image, start the image builder and then connect to it. If the image builder is not running the latest version of the WorkSpaces Applications agent, you are prompted to choose whether to start the image builder with the latest agent. Make sure that this option is selected, choose **Start**, and then connect to the image builder.
   + If you do not have an image builder that you want to use to create the image, launch a new image builder. In **Step 1: Choose Image**, choose an AWS base image or a custom image. In **Step 2: Configure Image Builder**, if the image that you choose is not running the latest version of the WorkSpaces Applications agent, the **WorkSpaces Applications** section displays. In the **Agent version** list, select the latest agent version. Complete the remaining steps to create the image builder, and then connect to it. For more information, see [Launch an Image Builder to Install and Configure Streaming Applications](tutorial-image-builder-create.md).

1. On the image builder desktop, open Image Assistant and follow the steps to create your new image. For the **Configure Image** step, make sure that **Always use the latest agent version** is selected. For more information, see [Tutorial: Create a Custom WorkSpaces Applications Image by Using the WorkSpaces Applications Console](tutorial-image-builder.md). 

   If you decide later to not always use the latest version of the WorkSpaces Applications agent, you must create a new image and clear that option.

1. Create a new fleet or modify an existing one. When you configure the fleet, select the new image that you created. For more information, see [Create an Amazon WorkSpaces Applications Fleet and Stack](set-up-stacks-fleets.md).

1. Create a new stack or modify an existing one and associate it with your fleet.

# Create an Image That Uses a Specific Version of the WorkSpaces Applications Agent
<a name="create-image-that-uses-specific-agent"></a>

You may want to control WorkSpaces Applications agent updates rather than always using the latest version so that you can test for compatibility first. To ensure that the version of the WorkSpaces Applications agent you use is compatible with your streaming applications, you can create an image that uses a specific version of the agent software. Then perform your qualification tests in a separate fleet before deploying to your production fleet. 

When you create the image, make sure that the **Always use latest agent version** option is not selected. Doing so pins your image to the version of the WorkSpaces Applications agent that you selected when you launched the image builder, rather than always using the latest version. After you finish your qualification tests, you can update your production fleet with the image.

**To create an image that uses a specific version of the WorkSpaces Applications agent**

1. Open the WorkSpaces Applications console at [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home).

1. Do either of the following: 
   + If you have an image builder that you want to use to create the image, start the image builder and then connect to it.
   + If you do not have an image builder that you want to use to create the image, launch a new image builder. In **Step 1: Choose Image**, choose an AWS base image or a custom image. In **Step 2: Configure Image Builder**, if the image that you choose is not running the latest version of the WorkSpaces Applications agent, the **WorkSpaces Applications** section displays. In the **Agent version** list, do not select the latest agent version. Complete the remaining steps to create the image builder, and then connect to it. For more information, see [Launch an Image Builder to Install and Configure Streaming Applications](tutorial-image-builder-create.md).

1. On the image builder desktop, open Image Assistant and follow the steps to create your new image. For the **Configure Image** step in Image Assistant, make sure that **Always use the latest agent version** is not selected. For more information, see [Tutorial: Create a Custom WorkSpaces Applications Image by Using the WorkSpaces Applications Console](tutorial-image-builder.md).

   If you decide later to always use the latest version of the WorkSpaces Applications agent, you must create a new image and select that option.

1. Create a new fleet or modify an existing one. When you configure the fleet, select the new image that you created. For more information, see [Create an Amazon WorkSpaces Applications Fleet and Stack](set-up-stacks-fleets.md).

1. Create a new stack or modify an existing one and associate it with your fleet.

1. Connect to your fleet and test your applications for compatibility.

# Create an Image That Uses a Newer Version of the WorkSpaces Applications Agent
<a name="create-image-that-uses-newer-agent"></a>

If you pin your image to a specific WorkSpaces Applications agent version, you must update to a newer version by creating a new image. This approach lets you test each agent update for compatibility first, and then update your fleet incrementally. 

When you create the image, make sure that the **Always use latest agent version** option is not selected. After you create your image, perform your qualification tests in a separate fleet before deploying to your production fleet. After you finish your qualification tests, you can update your production fleet with the image.

**To create an image that uses a newer version of the WorkSpaces Applications agent**

1. Open the WorkSpaces Applications console at [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home).

1. Do either of the following: 
   + If you have an image builder that you want to use to create the image, start the image builder and then connect to it. If the image builder is not running the latest version of the WorkSpaces Applications agent, you are prompted to choose whether to start the image builder with the latest agent. Make sure that this option is selected, choose **Start**, and then connect to the image builder.
   + If you do not have an image builder that you want to use to create the image, launch a new image builder. In **Step 1: Choose Image**, choose an AWS base image or a custom image. In **Step 2: Configure Image Builder**, if the image that you choose is not running the latest version of the WorkSpaces Applications agent, the **WorkSpaces Applications** section displays. In the **Agent version** list, select the latest agent version. Complete the remaining steps to create the image builder, and then connect to it. For more information, see [Launch an Image Builder to Install and Configure Streaming Applications](tutorial-image-builder-create.md).

1. On the image builder desktop, open Image Assistant and follow the steps to create your new image. For the **Configure Image** step in Image Assistant, make sure that **Always use the latest agent version** is not selected. For more information, see [Tutorial: Create a Custom WorkSpaces Applications Image by Using the WorkSpaces Applications Console](tutorial-image-builder.md).

   If you decide later to always use the latest version of the WorkSpaces Applications agent, you must create a new image and select that option.

1. Create a new fleet or modify an existing one. When you configure the fleet, select the new image that you created. For more information, see [Create an Amazon WorkSpaces Applications Fleet and Stack](set-up-stacks-fleets.md).

1. Create a new stack or modify an existing one and associate it with your fleet.

1. Connect to your fleet and test your applications for compatibility.