Getting Started
Install on Docker
Install Squidex on Linux machines with docker and docker-compose.
Supported platforms
Digital Ocean Droplets are not supported right now, because their DNS prevents that a container can make a request to itself, which is needed to get OIDC via Identity Server working properly. The issue has been discussed in the support forum.
Use the docker-compose setup
We provide a docker-compose configuration:
There are 3 alternatives:
Squidex + Caddy
docker-compose.yml with the following containers:The caddy proxy uses a custom image to configure the Caddyfile.
Recommended setup because of the performance of Caddy and the number of containers.
Squidex + NGINX
docker-compose-nginx.yml with the following containers:- Squidex
Recommended setup when you are familiar with Nginx and have special requirements.
Squidex without Proxy
docker-compose-noproxy.yml with the following containers:- Squidex
Recommended setup if you already have a reverse proxy (e.g. Cloudflare).
1. Download the files
Download the following files to your server:
docker-compose.yml.env
2. Configure Squidex
Open the
.env file and set the following variables:Variable
Description
SQUIDEX_DOMAINYour domain name, e.g. we use
cloud.squidex.ioSQUIDEX_ADMINEMAILThe email address of the admin user.
SQUIDEX_ADMINPASSWORDThe password of the admin user. Must contain a lowercase and uppercase letter, a number and a special character. Leaked passwords are also forbidden, check https://haveibeenpwned.com/Passwords first.
SQUIDEX_FORCE_HTTPSKeep it unchanged. You can set it to false to disable permanent redirects from http to https.
SQUIDEX_PROTOCOLKeep it unchanged. You can set it to http to disable secure connections.
You can keep the other settings empty for now.
3. Data Folder
The data will be stored outside of the docker container to simplify the backups. The default path /etc/squidex will be created by docker.
4. Run the docker-compose file
1
docker-compose up -d
Copied!
Troubleshooting
Please check the logs first using docker.
1
docker ps # Get the container id first
2
docker logs <CONTAINER-ID> # Read the logs
Copied!
I get a 502 Bad Gateway
In my tests it took sometime to issue the certificate. Probably around 10 minutes.
Also ensure that your DNS server is configured correctly.
I cannot login and see a IDX20803 error code in my logs
In some cases, especially on CentOS 7, the communication between docker containers on the same host is blocked by the firewall. There is an open issue on Github for this problem.
The solution that worked in our cases was to add https as a service to the firewall:
1
sudo firewall-cmd --add-service=https --permanent --zone=trusted
2
sudo firewall-cmd --reload
Copied!
I see a IDX20803: Unable to obtain configuration from: <IP> in the logs
This problem is because you use an host name or IP address that is not reachable from the docker itself. You can think about the Squidex being two processes in one application. There is the OpenID Connect Server (Identity Server) that generates the access tokens and the API. When the API receives an access token it makes a request to the Identity Server to validate the token (See following diagram).
Authentication Flow
When you use a local host name or IP address such as
localhost or 127.0.0.1your are referring to the host name. But containers inside docker cannot resolve the network routes and therefore the authentication flow fails. The solution is to either use another local hostname, that you have to configure in the host file of your Operation system or to use a real hostname, such as a public domain name.More issues?
It is very likely a configuration problem and not related to hosting under Docker. Checkout
Last modified 5mo ago
Copy link
Contents
Supported platforms
Use the docker-compose setup
1. Download the files
2. Configure Squidex
3. Data Folder
4. Run the docker-compose file
Troubleshooting
I get a 502 Bad Gateway
I cannot login and see a IDX20803 error code in my logs
I see a IDX20803: Unable to obtain configuration from: <IP> in the logs
More issues?