# Deploy WorkSpaces Manager Appliance via CloudFormation

Choose the region where you would like to deploy your WorkSpaces Manager appliance, then click on "**Continue to Configuration**".

<figure><img src="/files/n6MXEilDdgLXG6hU27VW" alt=""><figcaption></figcaption></figure>

Next, click on "**Continue to Launch**".

<figure><img src="/files/maJYMQKWTel6pReczNqs" alt=""><figcaption></figcaption></figure>

From the "**Choose Action**" dropdown, select "**Launch CloudFormation"**. Then, click on "**Launch**".

<figure><img src="/files/Jsy7IbaIAZztrGP2fmbh" alt=""><figcaption></figcaption></figure>

In the next section, accept all the default entries and click on "**Next**".

<figure><img src="/files/RqqLh3o2wZQyulhvf1Xe" alt=""><figcaption></figcaption></figure>

Now, specify the parameters for the CloudFormation stack configuration. Start by providing a **Stack Name** for the CloudFormation stack, such as "**CF-WSMv6**". It’s recommended to name the object using the acronym of the service being used in AWS, like starting with "CF" for CloudFormation.

<figure><img src="/files/fPdBLTBM2oXgfQ3EKDgO" alt=""><figcaption></figcaption></figure>

Enter:

* **VPC**: From the drop-down menu, choose the VPC where you want to deploy WorkSpaces Manager.
* **Subnet**: Select a private subnet from the available options within your chosen VPC to host the WorkSpaces Manager.
* **Subnet**: Select a private subnet from the available options within your chosen VPC to host the WorkSpaces Manager.
* **Subnet**: Select a private subnet from the available options within your chosen VPC to host the WorkSpaces Manager.
* **RDP Location CIDR**: Specify the CIDR block that will allow WorkSpaces users and administrators to access the WorkSpaces Manager. You can modify this setting later by navigating to **AWS Console > EC2 > Security Groups**.

{% hint style="danger" %}
You will need the associated PEM or PPK key file to decrypt the password later. It’s recommended to store the key in **AWS Secrets Manager** for future access and security.
{% endhint %}

Now, configure the additional options:

1. **Tags:** It's strongly recommended to tag your resources if desired.
2. **Permissions:** Leave this blank as the necessary permissions will be created automatically.
3. **Advanced Options:** Keep all settings at their default values. If you wish, you can enter an **SNS Topic ARN** to receive notifications when the stack is created, but this is optional. You'll know the process is complete when the WorkSpaces Manager appears as an EC2 instance in the console.

After configuring the options, click on "**Next**".

<figure><img src="/files/fSlCXvTT70EsMD0yUPQV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/DIqODtDZar7pc9bbAVFB" alt=""><figcaption></figcaption></figure>

You will now be on the **Review** screen. Scroll down to the bottom, check the acknowledgment box, and then click on "**Next"**.

<figure><img src="/files/swHF543n4ODhWseNXoRw" alt=""><figcaption></figcaption></figure>

A summary of your configuration will be displayed. Once you have reviewed it, click on "**Submit"** to begin the deployment.

<figure><img src="/files/2CjELZZ1AlakRFi7ARwy" alt=""><figcaption></figcaption></figure>

You will be redirected back to the stack status screen, where you can track the progress of the WorkSpaces Manager stack creation.

<figure><img src="/files/KIO1CM0ZGTEraZzwdjWP" alt=""><figcaption></figcaption></figure>

You can monitor the tasks as they are being executed. Once the stack creation is complete, the status will change from **CREATE\_IN\_PROGRESS** to **CREATE\_COMPLETE**. The entire process typically takes around 3 to 4 minutes to finish.

<figure><img src="/files/wjGIt5NCwOjsds9aNejb" alt=""><figcaption></figcaption></figure>

If you now check your EC2 instances in the region where you installed WorkSpaces Manager, you should see the WorkSpaces Manager instance. Allow approximately 15-20 minutes for the status checks to complete and for the local administrator password to be automatically generated.

<figure><img src="/files/WinBbMlhvljofGSZrgxt" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuvens.cloud/install/installation-procedure/deploy-workspaces-manager-appliance-via-cloudformation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.