Install on Azure

Search…
Install on Azure
Learn how to setup Squidex as Azure WebApp with an integrated MongoDB container.
Please note that azure also supports Docker compose files so you can also follow the Docker tutorial, especially if it is important for you to be independent from your cloud provider.
In this tutorial I will also not teach you the basics of Azure. it is a very complicated product with thousands of features and you should be familiar with the basics before you follow this tutorial or just learn it on the fly.
Requirements
Before you start you have to setup a few things first:
1.A resource group for all your squidex resources.
2.A service plan to host Squidex (Linux).
3.A storage account for your assets and mongo db (general purpose v1 or v2).
4.​Azure-CLI installed.
5.The Microsoft.ContainerInstance provider registered in your Azure subscription.
1. Create the web app
Create a new web app with the following Basics:
Create App Service Basics
Configure the Docker tab like this:
Create App Service Docker
2. Enable logging
In the next step we enable logging. This makes diagnostics easier.
Go to your app service and scroll down to menu item App Service logs and turn on file logging. You can then use the Log stream to view all log entries.
Enable logging
3. Configure your storage account
Go to your storage account instance, choose Files and create a file share named 'etc-squidex-mongodb'.
Choose Blobs and create a container named 'etc-squidex-assets'.
Choose Access Keys and copy one of the keys for the setup of the MongoDB and one Connection String for the setup of the Squidex asset store.
4. Create the container instance
The following setup of the container instance can only be done using the azure-cli at the moment. Open a terminal, login to azure using az login and run the following command.
1
  az container create --resource-group [YOUR VALUE HERE] --name mongodb --image mongo --azure-file-volume-account-name [YOUR VALUE HERE] --azure-file-volume-account-key "[YOUR VALUE HERE]" --azure-file-volume-share-name etc-squidex-mongodb --azure-file-volume-mount-path "/data/mongoaz" --ports 27017 --cpu 2 --ip-address public --memory 2 --os-type Linux --protocol TCP --command-line "mongod --dbpath=/data/mongoaz --bind_ip_all"
Copied!
This will create a container Instance with a single container running mongo db.
If you receivce the error message The subscription is not registered to use namespace Microsoft.ContainerInstance when creating the container, then the Container Instances provider is not registered in your Azure subscription. See this article for details.
To register the provider, run the following command:
1
az provider register --namespace Microsoft.ContainerInstance
Copied!
IMPORTANT: At this point your MongoDB will run without authentication. Connect to it with a Tool of your choice like Robo 3T and create an admin user. After that run the above command again, but change the --command-line argument to
1
"mongod --dbpath=/data/mongoaz --bind_ip_all --auth"
Copied!
5. Configure your application
Go to the Configuration section and choose Application settings to configure squidex.
IMPORANT: After you change your configuration values you have to restart your container. In our case the only option was to stop the app service and then start it again. The restart button did not work. Please write a comment if you know a better solution.
All configuration values
Configuration values for external authentication providers are empty to turn them off.
6. All settings
All basic settings:
1
[
2
  {
3
    "name": "ASSETSTORE__AZUREBLOB__CONNECTIONSTRING",
4
    "value": "[YOUR VALUE HERE]",
5
    "slotSetting": false
6
  },
7
  {
8
    "name": "ASSETSTORE__AZUREBLOB__CONTAINERNAME",
9
    "value": "etc-squidex-assets",
10
    "slotSetting": false
11
  },
12
  {
13
    "name": "ASSETSTORE__TYPE",
14
    "value": "AzureBlob",
15
    "slotSetting": false
16
  },
17
  {
18
    "name": "DOCKER_REGISTRY_SERVER_PASSWORD",
19
    "value": "",
20
    "slotSetting": false
21
  },
22
  {
23
    "name": "DOCKER_REGISTRY_SERVER_URL",
24
    "value": "https://index.docker.io",
25
    "slotSetting": false
26
  },
27
  {
28
    "name": "DOCKER_REGISTRY_SERVER_USERNAME",
29
    "value": "",
30
    "slotSetting": false
31
  },
32
  {
33
    "name": "EVENTSTORE__MONGODB__CONFIGURATION",
34
    "value": "mongodb://[YOUR ADMIN]:[YOUR PASSWORD]@[YOUR IP]:27017",
35
    "slotSetting": false
36
  },
37
  {
38
    "name": "IDENTITY__ADMINEMAIL",
39
    "value": "[email protected]",
40
    "slotSetting": false
41
  },
42
  {
43
    "name": "IDENTITY__ADMINPASSWORD",
44
    "value": "[YOUR VALUE HERE]",
45
    "slotSetting": false
46
  },
47
  {
48
    "name": "IDENTITY__GITHUBCLIENT",
49
    "value": "",
50
    "slotSetting": false
51
  },
52
  {
53
    "name": "IDENTITY__GITHUBSECRET",
54
    "value": "",
55
    "slotSetting": false
56
  },
57
  {
58
    "name": "IDENTITY__GOOGLECLIENT",
59
    "value": "",
60
    "slotSetting": false
61
  },
62
  {
63
    "name": "IDENTITY__GOOGLESECRET",
64
    "value": "",
65
    "slotSetting": false
66
  },
67
  {
68
    "name": "IDENTITY__MICROSOFTCLIENT",
69
    "value": "",
70
    "slotSetting": false
71
  },
72
  {
73
    "name": "IDENTITY__MICROSOFTSECRET",
74
    "value": "",
75
    "slotSetting": false
76
  },
77
  {
78
    "name": "STORE__MONGODB__CONFIGURATION",
79
    "value": "mongodb://[YOUR ADMIN]:[YOUR PASSWORD]@[YOUR IP]:27017",
80
    "slotSetting": false
81
  },
82
  {
83
    "name": "URLS__BASEURL",
84
    "value": "https://squidex-test.azurewebsites.net/",
85
    "slotSetting": false
86
  },
87
  {
88
    "name": "VIRTUAL_HOST",
89
    "value": "squidex-test.azurewebsites.net",
90
    "slotSetting": false
91
  },
92
  {
93
    "name": "WEBSITE_HTTPLOGGING_RETENTION_DAYS",
94
    "value": "10",
95
    "slotSetting": false
96
  }
97
]
Copied!
More issues?
It is very likely a configuration problem and not related to hosting under azure. Go to the Configuration page.
Install on AWS
Install on Docker
Last modified 13h ago
Copy link
Contents
Requirements
1. Create the web app
2. Enable logging
3. Configure your storage account
4. Create the container instance
5. Configure your application
6. All settings
More issues?