# Install on AWS (Deprecated)

{% hint style="danger" %}
The following AWS Marketplace Image is no longer available. We are working on updating the instructions.
{% endhint %}

## 1. Use the AWS Marketplace Image

Squidex is available in the AWS Marketplace as a listing. To begin, click the **Deploy to AWS** button below.

[![Deploy on AWS](https://img.shields.io/badge/-Deploy%20to%20AWS-232F3E?style=for-the-badge\&logo=amazon-aws\&logoColor=ffffff)](https://aws.amazon.com/marketplace/pp/prodview-zvohj6i2bye7w)

## 2. Subscribe

Squidex is free, but you still need to subscribe to the Amazon Marketplace listing.

In the listing page, click **Continue to Subscribe** (1).

<div align="left"><figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2FHiwvUqnjbf5PNT2WxQ3x%2F2023-05-02_11-45.png?alt=media&#x26;token=0c437cbc-ed1b-401f-9933-81768c7890b5" alt=""><figcaption><p>Subscribe to AWS marketplace listing</p></figcaption></figure></div>

Read the EULA and accept the terms by clicking **Accept Terms** (2).

<div align="left"><figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2FxVsAJrWz4FMtXjm8mNFg%2F2023-05-02_11-48.png?alt=media&#x26;token=cb6ba710-2c5d-461e-bef1-3e27a8851e4b" alt=""><figcaption><p>Accept terms to subscribe to the listing</p></figcaption></figure></div>

Wait until AWS processes your subscription (3).

<div align="left"><figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2FdrOidZAHK9oWGJKwlisg%2F2023-05-02_11-49.png?alt=media&#x26;token=b058a873-8d60-4eb4-8f25-3c53bea72edf" alt=""><figcaption><p>Subscription being processed by AWS</p></figcaption></figure></div>

Once that is ready, click **Continue to Configuration** (1).

<div align="left"><figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2F58NE3jKhPPMxfVKMB8d3%2F2023-05-02_11-51.png?alt=media&#x26;token=faf42a1b-6a7e-42d1-a90a-a5aa1cf97c9d" alt=""><figcaption><p>Continue to Configuration</p></figcaption></figure></div>

## 3. Instance Configuration

Pick a **Delivery Method** (1), a **Software Version** (2) and a **Region** (3), then click **Continue to Launch** (4).

<div align="left"><figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2F2D5yVqE9yirSmxKjCwjo%2F2023-05-02_14-06.png?alt=media&#x26;token=53ee4114-bdf1-4f70-8141-9c00c2246cb1" alt=""><figcaption><p>Choose a software configuration</p></figcaption></figure></div>

This will take you to the configuration of the EC2 instance to be launched.

Pick the **EC2 Instance Type** (5). We recommend at least a **m5.large**.

<div align="left"><figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2F86I1msIB16xvRw15nYdD%2F2023-05-04_17-06.png?alt=media&#x26;token=f1fe8cfe-5ef6-4f93-a710-9799623d983d" alt=""><figcaption><p>Choose an instance type</p></figcaption></figure></div>

Scroll down and select a **VPC** (6) and **Subnet** (7) from the pre-populated list. Next, select a **Security Group** (8) or click **Create New Based On Seller Settings** to automatically create one based on Squidex requirements.&#x20;

<figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2F3zsYHPeoyUQUnReM6UBl%2F2023-05-04_17-10.png?alt=media&#x26;token=591dedee-14e2-49f0-9d89-d7bd64cbaa27" alt=""><figcaption><p>Choose network configuration and security group</p></figcaption></figure>

Finally, select a **Key Pair** (9) and click **Launch** (10).&#x20;

{% hint style="info" %}
You must have an AWS Key Pair and selected here, otherwise you will not be able to login to the EC2 instance later.
{% endhint %}

<div align="left"><figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2FsWYGSsDs1WtJ6MqSnRmz%2F2023-05-04_17-19.png?alt=media&#x26;token=0db32aef-8838-4445-b561-494e8468bd9c" alt=""><figcaption><p>Select key pair and launch</p></figcaption></figure></div>

Once the instance is launched, go to the **EC2 Console** (11).

<figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2FEPjXACM0S5blTKvJb0XO%2F2023-05-02_15-19.png?alt=media&#x26;token=17fb1657-3dbe-42fd-88e4-77501ebef139" alt=""><figcaption><p>EC2 instance successfully deployed</p></figcaption></figure>

## 4. Connect

Once the instance is ready, take its **Public IPv4** (1) and connect to it using SSH and the key pair you selected previously.

<figure><img src="https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2FJqoabvZlMf6BkHdGIzIM%2F2023-05-02_15-15.png?alt=media&#x26;token=4446d332-c8b6-4161-ab8e-b9bbf22c6051" alt=""><figcaption><p>Retrieve Public IP</p></figcaption></figure>

```bash
ssh -i path/to/keypair.pem ubuntu@[PUBLIC IP]
```

Once you are logged in, run the setup command and follow the on-screen instructions.

```bash
/opt/squidex/setup-squidex.sh
```

You will be asked to enter the domain here. All other values are optional. The installation script will start *docker-compose,* download all images and start them in the right order.

After you make sure the domain you configured is pointing to the public IP of your instance and that the DNS changes propagated, go to <https://your_domain.com> and you should be ready to go.

For further help, go to [Configuration](https://docs.squidex.io/01-getting-started/installation/configuration).

## Troubleshooting

For other issues, it is likely that you have a configuration problem not related to hosting under Docker. Checkout the following documentation:

{% content-ref url="../configuration" %}
[configuration](https://docs.squidex.io/id-01-getting-started/installation/configuration)
{% endcontent-ref %}