# Install on AWS EC2 using Docker The instructions provided here help you get Squidex running on an AWS EC2 instance using Docker containers. It uses an EC2 instance running Docker and deploys Squidex along with NGINX for reverse proxy and MongoDB as the database. The data is stored outside of the containers for persistence but on the same instance (single volume). This tutorial does not cover the basics of AWS. You should be familiar with them before you begin with the instructions. We have attempted to keep them simple enough so they can be followed by anyone. This tutorial runs all containers i.e. Squidex, MongoDB and NGINX in a single EC2 instance and may not be recommended for production environments. ## Requirements Before you start ensure you have: 1. An active AWS account. 2. A domain name to be used with Squidex. ## 1. Launch an EC2 Instance To launch an instance, login to AWS Console and select the desired **region** (1) from the drop down on the right. For this demonstration *us-east-1* has been used.

Navigate to the EC2 Dashboard at . Click **Launch instance** (2) to begin. {% hint style="info" %} This demonstration uses a lot of the default values and is just a quick way to get an EC2 instance running. One can always customize the network, storage and other parameters which is beyond the scope of this guide. {% endhint %}

Start by giving a name for the **EC2 instance** (3).

Next, select **Ubuntu** (4) as the AMI.

Select an **Instance type** (5). We recommend at least the **m5.large**. But for sandbox/experimental requirements you can choose a lower configuration.

Select a **Key pair** (6) to be able to connect to the EC2 instance later. {% hint style="info" %} You must have an AWS Key Pair and select here, otherwise you will not be able to login to the EC2 instance later. If required, click **Create new key pair** to create one and then select it from the list. {% endhint %}

For Network settings ensure **Allow HTTP** and **Allow HTTPS** (7) traffic is checked. For this demonstration we will leave the rest to their defaults.

Similarly, for this guide we will not make any changes to storage but one can choose a larger disk size based on requirements. Click **Launch instance** (8) when ready.

This should initiate the launch the EC2 instance. Click on the instance ID (9) to navigate to the instance details.

## 2. Configure DNS Once the instance is ready, copy its **Public IPv4** (1) address and configure the DNS mapping i.e ensure that the domain you wish to use with Squidex is pointing to this IP. This typically involves creating an A record to the domain/subdomain you wish to use for Squidex. It is recommended to wait for the DNS changes to propagate before proceeding further. The mapping is necessary for successful deployment of Squidex and is also used to request SSL certificates.

## 3. Connect and Install Docker Next, connect to the EC2 instance using SSH. Use the key pair selected during instance launch. ```bash ssh -i path/to/keypair.pem ubuntu@[PUBLIC IPv4] ``` {% hint style="info" %} *ubuntu* is the default username for Ubuntu AMI. {% endhint %} At this point the instance does not have Docker. We will go ahead and install it by running the following commands: ``` # Install Docker curl -fsSL https://get.docker.com -o get-docker.sh sh get-docker.sh # Add current user to docker group sudo usermod -aG docker $USER ``` Next, logout and login back to the EC2 instance and verify that Docker commands run without the need for *sudo*. {% hint style="danger" %} It is important to logout and login to apply the changes made earlier where the current user was added to docker group. {% endhint %} ``` docker --version ``` ## 4. Deploy Squidex Once Docker is installed, the instructions to run Squidex using Docker containers is the same as [install-on-docker](https://docs.squidex.io/id-01-getting-started/installation/platforms/install-on-docker "mention"). We provide multiple Docker Compose files to quickly get started with Squidex. They can be downloaded from . In the demonstration below we will run Squidex with NGINX and MongoDB using the `docker-compose-nginx.yml` file. Start by downloading the required files. ```bash // Download the yml file wget https://raw.githubusercontent.com/Squidex/squidex-hosting/master/docker-compose/docker-compose-nginx.yml // Download the environment file wget https://raw.githubusercontent.com/Squidex/squidex-hosting/master/docker-compose/.env ``` Edit the `.env` file and set the following variables:

Variable	Description
`SQUIDEX_DOMAIN`	Your domain name, that you want to use for your installation.
`SQUIDEX_ADMINEMAIL`	The email address of the admin user. You can leave it empty to create a new user with the setup page when you visit your Squidex installation in the browser.
`SQUIDEX_ADMINPASSWORD`	The password of the admin user. Must contain a lowercase and uppercase letter, a number and a special character. You can leave it empty to create a new user with the setup page when you visit your Squid

The rest variables can be empty for now. The data files, such as assets and the MongoDB database files will be stored, outside of the Docker container for persistence and to simplify backups. The default path `/etc/squidex` will be created by Docker automatically. Run the docker-compose file with the following command: ``` docker compose -f docker-compose-nginx.yml up -d ``` {% hint style="info" %} Using `-f docker-compose-nginx.yml` (or providing absolute path of the yaml file) is mandatory else the command will fail. {% endhint %} Docker compose will download all images and start them in the right order. To access Squidex, navigate to the domain name used in this installation, for example and you are ready to go. For further help, go to [Configuration](https://docs.squidex.io/01-getting-started/installation/configuration). --- # 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.squidex.io/id-01-getting-started/installation/platforms/install-on-aws-ec2.md?ask= ``` 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.