Links

Install on Azure using ARM

This version of the installation tutorial deploys Squidex along with MongoDB (for datastore) and Caddy (for reverse proxy along with SSL) as a Container Group in Azure using an Azure Resource Manager or ARM template. The approach is called Infrastructure as Code.
The tutorial does not cover the basics of Azure. You should be familiar with them before you begin with the installation instructions.
This tutorial runs MongoDB as a single container and is recommended for non-production or trial environments. For production environments it is recommended to use one of the MongoDB Atlas (or Enterprise) offerings from Azure marketplace, which provides capabilities such as High Availability.
Use this tutorial as a getting started guide in Azure to explore Squidex and use it as a Dev/Sandbox environment. This setup may not be recommended for a production environment.

Pre-requisites

Before you begin, ensure you meet the following requirements:
  1. 1.
    An active Azure subscription.
  2. 2.
    The following providers registered in your Azure subscription:
    • Microsoft.ContainerInstance
    • Microsoft.Storage

Deployment Specifications & Other Details

The ARM template creates the following Azure resources:
  • An Azure Storage Account
    • Azure Container
    • Azure Share
  • Azure Container Instances (Group)
    • Squidex Web App Container (latest image)
    • MongoDB Container (latest image)
    • Caddy container (latest image)
Important Details
  • Default resource allocations
    • Squidex container: 1 vCPU and 1.5 GiB memory
    • MongoDB container: 2 vCPU and 2 GiB memory
    • Caddy container: 1 vCPU and 1.5 GiB memory
  • Squidex and MongoDB containers remain private and are not exposed to public.
  • Squidex talks to MongoDB without authentication (mongodb://localhost:27017). Since MongoDB is private it cannot be accessed from outside, hence secure to an extent. With the current setup you cannot connect using an external client like MongoDB Compass. You can however connect from Azure Container Instance, click here for instructions
  • Caddy reverse proxies to the Squidex Web App container.
  • An FQDN is provided by Azure Container Instance, Caddy provides SSL for this as the FQDN does not come with SSL. This FQDN is set as the URLS__BASEURL and VIRTUAL_HOST for Squidex configuration.
NOTE: If you wish to modify any of the variables such as vCPU, Memory etc., you can do so by editing the ARM template. Click [here](#modifying-arm-variables) for basic instructions.

1. Launch the ARM Template

Simply click Deploy to Azure button to load the template in Azure Portal, fill in a few details (instructions below) and deploy Squidex.

2. Configure Details

On the Custom deployment page complete the following steps to submit the deployment.
  1. 1.
    Select your Subscription from the list.
  2. 2.
    Select an existing Resource group or click Create new to create a new Resource group.
    • If creating a new Resource group, enter a name and click Ok.
  3. 3.
    Select your preferred Region from the list.
  4. 4.
    Enter a name for the Container Group in Container Name field. (It uses the Resource Group name by default but you are free to change it)
  5. 5.
    If you wish to provide your own Domain/Sub-domain (e.g. example.com or squidex.example.com) enter it in the Squidex Domain field, otherwise leave it blank.
  6. 6.
    Click Review + create.
Deploy ARM Template
  1. 1.
    Ensure that the validation is successful.
  2. 2.
    Click Create to submit the deployment.
Review ARM Template
The deployment process will take a few minutes. (Preferably do not navigate away from this page)

3. Access Squidex

  1. 1.
    Once the deployment is complete, Click Outputs in the deployment page to retrieve the URL.
  2. 2.
    Copy the URL.
Deployment Complete
Alternatively, you can also retrieve the FQDN anytime from the Azure Container Instances blade.
NOTE: This is only for deployments where custom domain is NOT provided
ACI FQDN

4. Update DNS record (For Own Domain Deployments Only)

  1. 1.
    Navigate to Azure Container Instances page, click on the Container instance (i.e. squidex) to access the details.
  2. 2.
    Under Overview, to the right you should find the IP Address (Public) value, copy it.
ACI PublicIP
  1. 1.
    Now access your domain control panel, and create an A Record pointing your domain to this IP Address.
  2. 2.
    Continue with the next steps once the DNS propagation is done, this would depend on your domain provider.
NOTE: The SSL certificates are not generated (by Caddy) until the DNS resolution works

5. Complete Squidex Installation

  1. 1.
    Open the URL in a browser to load the Squidex Installation Page.
It may take a few minutes before the certificates are generated and the URL starts working. For own domain scenarios this process may be even longer
  1. 1.
    Create the Admin User to complete the installation and login to Squidex.

Azure Troubleshooting

  1. 1.
    Validation failed
    • Ensure all the fields have been populated.
    • If you are rerunning the ARM template (either another installation or due to a previous failure) and using the same names, change them (or delete previously created resources).
  2. 2.
    Deployment failed
In the Microsoft template deployment window click Deployment failed. Click here for more details to view the error details and look for clues. This tutorial does not go into the details of Azure troubleshooting.
NOTE: Use _Redeploy_ to resubmit the deployment again (after fixing errors). This continues the operation instead of creating a fresh deployment.
  1. 1.
    Containers in waiting, failed or terminated status.
    • Restart the Azure Container Instance
Deployment Complete

Squidex Issues

It is very likely a configuration problem and not related to Azure. Please visit the following page:

Connecting to MongoDB instance

  1. 1.
    On the Azure Portal, navigate to Container Instances page
  2. 2.
    Click on your Container Instance (e.g. squidex-crm)
  3. 3.
    Select Containers from the left navigation menu
  4. 4.
    Select the MongoDB container (i.e. etc-squidex-assets-mongodb) by clicking on it
  5. 5.
    Select the Connect tab
  6. 6.
    Ensure /bin/bash is selected
  7. 7.
    Click Connect again
Connect to MongoDB ACI
This will drop you into the Container Shell. Type mongosh to connect to MongoDB shell.

Modifying ARM Variables

  1. 1.
    After clicking Deploy to Azure button, click Edit template.
Edit Template
  1. 1.
    Click Variables on left and this should show the variables section on the right.
  2. 2.
    You can now change any of the variables such as mongoDBCPUCores or mongoDBMemory etc.
Modifying ARM Variables