> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/pbi-guides/pbi-private-access-administrators-guide/appendix/appliance-registration/aws-appliance.md).
# AWS Appliance
1. Download the AWS appliance image from the PBI Management Portal.
2. Unzip the appliance archive to get a VHD file. For example, `prls-vm-amazon-x.0.0-xxxx-xxxxxxxx.vhd`.
3. In AWS S3, create a bucket with any name. Leave the remaining settings at their default values.
4. Open the new bucket and click **Upload**.
5. Select the VHD file you extracted earlier, then upload it.
6. Update the `vmimport` policy with the following statements:
```
{
"Effect": "Allow",
"Action": [
"ec2:ModifySnapshotAttribute",
"ec2:CopySnapshot",
"ec2:RegisterImage",
"ec2:Describe*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"s3:GetBucketLocation",
"s3:GetObject",
"s3:ListBucket",
"s3:PutObject",
"s3:GetBucketAcl"
],
"Resource": [
"arn:aws:s3:::your_bucket_name",
"arn:aws:s3:::your_bucket_name/*"
]
}
```
7. In CloudShell, import a snapshot and wait for the task to complete.
`aws ec2 import-snapshot`\
`--description "some_description"`\
`--disk-container "Format=VHD,UserBucket={S3Bucket=your_bucket_name,S3Key=vhd_file_name.vhd}"`
`aws ec2 describe-import-snapshot-tasks`\
`--import-task-ids import_task_id`
8. Open the list of snapshots, select the snapshot with the `SnapshotId` from the output above, and click **Create image from snapshot**.
9. Enter an image name. You may leave the remaining settings at their default values.
10. After the image is created, select it from the list, then click **Launch instance from AMI**.
11. Specify the following parameters, then proceed:
* **Name**: enter any instance name.
* **Instance type**: Use `t3.medium`, or another type based on your planned number of concurrent users.
* **Key pair name**: Choose to proceed without a key pair.
* **VPC/subnet**: Choose where to place the instance.
* **Auto-assign public IP**: Disable this if the instance should use only a private IP from your subnet.
* **Security group**: Create a new group or select an existing one. Ensure it allows inbound TCP traffic on port `80`.
12. After the instance is created, open its configuration and note the instance IP address.
13. Wait until the configuration page is available at `http://instance_ip_address`.
14. If you use a public IP address, disable all inbound firewall rules after the appliance is registered in the Admin portal.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.parallels.com/landing/pbi-guides/pbi-private-access-administrators-guide/appendix/appliance-registration/aws-appliance.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.