Install on IIS
Install Squidex on Windows with IIS and a custom MongoDB server.
Last updated
Was this helpful?
Install Squidex on Windows with IIS and a custom MongoDB server.
Last updated
Was this helpful?
You can also read this useful guide from Microsoft, How to .
This document is just a shorter version of the official guide.
The following operating systems are supported:
Windows 7 or later
Windows Server 2008 R2 or later
If you're reading this page and you're planning to setup Squidex under Windows, you are probably already familiar with IIS and have it installed on your machine. If not you can read the docs:
Download the installer using the following link:
Ensure that the ASPNETCORE_ENVIRONMENT
environment variable is set to Production
Following the official setup instructions:
Go to the release page and download the binaries.zip
file from the latest release:
Create a folder for your Squidex installation and extract the archive to this folder.
In IIS Manager, open the server's node in the Connections panel. Right-click the Sites folder. Select Add Website from the contextual menu.
Ensure that you also create an https binding with a proper certificate or development certificate. Due to recent security changes in Chrome, you are no longer able to login to Squidex if you are using http instead of https. You can also use Cloudflare as https termination if you don't want to pay for a certificate.
Confirm the process model identity has the proper permissions.
If the default identity of the App pool (Process Model > Identity) is changed from ApplicationPoolIdentity
to another identity, verify that the new identity has the required permissions to access the App's folder, database, and other required resources. For example, the App pool requires read and write access to folders where the app reads and writes files.
Under the server's node, select Application Pools.
Right-click the site's App pool and select Basic Settings from the contextual menu.
In the Edit Application Pool window, set the .NET CLR version to No Managed Code:
Go to your Squidex installation folder.
Create a file called appsettings.Production.json
which overrides the default settings. When you make an update and download a newer release your customized settings will not be overridden. You can also configure all settings with environment variables which is the recommended method for all other platforms, but in this case a file is easier.
Enter the following settings. The baseUrl
is the most important setting as it must match the domain that you're using. All other settings are optional. If you use a version lower than 5.6 you must define the initial username and password in settings.
Squidex logs to standard output.
To forward the logs to a file, open web.config
and set stdoutLogEnabled="true"
.
Ensure that the Physical path of your site points to the correct location.
It is very important that you restart IIS after you have installed the .NET Core Windows Server Hosting package. Restart the server or execute net stop was /y
followed by net start w3svc
from a command prompt with elevated permissions to pick up a change to the system PATH.
This can happen when you try to make an API call with the PUT or DELETE verb. For example when you use the Management UI. The reason is that WebDAV might be installed on your server and it blocks these verbs. You have to add the following lines to the web.config
file.
Ensure that the ASPNETCORE_ENVIRONMENT
environment variable is set to Production
.
Squidex logs all environment variables on the first start. Search for the following output in the logs:
To fetch the referenced content items or assets the user interfaces makes an API call where all IDs are added to the query string. When you have too many items, the query string becomes too long and IIS will return a 404
status code. Newer versions of Squidex will fall back to POST requests but you can also increase the request limit.
For other issues, it is likely that you have a configuration problem not related to hosting under IIS. Checkout the following documentation:
Provide a SiteName and set the Physical path to the Squidex folder that you created in the previous step. In this case we host Squidex at
Start the IIS site and go to . Login and start editing.