Skip to content

Commit 988bcb0

Browse files
feat: language review
1 parent 9bff73d commit 988bcb0

File tree

1 file changed

+17
-8
lines changed

1 file changed

+17
-8
lines changed

content/en/docs/deployment/general/deployment-location.md

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,22 +19,24 @@ For apps deployed to Mendix Cloud, you can customize a URL by adding [custom dom
1919

2020
If you specify an app URL location on a (sub)path, the Mendix runtime needs to know the public URL of your application. This can be done by setting the [custom runtime setting](/refguide/custom-settings/#applicationrooturl-section) `ApplicationRootUrl`.
2121

22-
When hosting a Mendix application on a subpath, the proxy needs to forward the request from `https://subdomain.domain/my/sub/path` to the internal address where the Mendix runtime is running. See the snippet below for an example Nginx config.
22+
When hosting a Mendix application on a subpath, the proxy needs to forward the request from `https://subdomain.domain/my/sub/path` to the internal address where the Mendix runtime is running. Refer to the code snippet below for an example Nginx Nginx configuration.
2323

2424
```
25-
# Location block for the subpath `/my/sub/path`.
25+
# Location block for the subpath "/my/sub/path".
26+
2627
location /my/sub/path/ {
28+
2729
# Make the Mendix runtime aware of https, see documentation below for more information.
2830
proxy_set_header X-Forwarded-Proto "https";
2931
3032
# Forward the host to the Mendix runtime.
3133
proxy_set_header X-Forwarded-Host $host;
3234
3335
# Forward the prefix `/my/sub/path` to the Mendix runtime.
34-
proxy_set_header X-Forwarded-Prefix /my/sub/path
36+
proxy_set_header X-Forwarded-Prefix /my/sub/path;
3537
3638
# Optional: forward a port when not running on standard ports.
37-
# proxy_set_header X-Forwarded-Port 3000
39+
# proxy_set_header X-Forwarded-Port 3000;
3840
3941
# Required for Mendix DevTools to work.
4042
proxy_http_version 1.1;
@@ -50,14 +52,21 @@ Routing based on a subpath is possible as of Studio Pro 10.3 (for details, see t
5052
If you want to deploy several apps on the same domain, use different subdomains to identify the app. For example, use `https://appA.apps.mydomain.com/`, not `https://mydomain.com/apps/appA`.
5153
{{% /alert %}}
5254

53-
## Secure cookies for on-premise applications
55+
## Secure Cookies for On-Premise Applications
56+
57+
The Mendix runtime automatically sets cookies with the `secure` attribute when applications are served over HTTPS. However, when deploying a Mendix application behind a load balancer that uses HTTP for internal communication, additional configuration is required.
58+
59+
In this case, the Mendix runtime must be explicitly informed that end-users are accessing the application via HTTPS. This can be done through either of these methods:
5460

55-
The Mendix runtime sets cookies with the `secure` attribute when the application is served over `https`. However, in a scenario where the Mendix runtime is served from behind a loadbalancer using `http` for the internal communication, the Mendix runtime needs to be made aware that it is served over `https` to the end-users. This can be done by setting the [ApplicationRootUrl](/refguide/custom-settings/#applicationrooturl-section) Runtime setting to a `https://` link, or by setting the `X-Forwarded-Proto` or `X-Forwarded-Schema` header to `https` in the loadbalancer.
61+
* Configure the [ApplicationRootUrl](/refguide/custom-settings/#applicationrooturl-section) runtime setting with an `https://` URL
62+
* Set the `X-Forwarded-Proto` or `X-Forwarded-Schema` header to `https` in the loadbalancer.
5663

5764
{{% alert color="info" %}}
58-
For Mendix versions prior to Mendix 10.18 setting the [ApplicationRootUrl](/refguide/custom-settings/#applicationrooturl-section) Runtime setting to a `https://` link will not make the application aware of it being served via `https`. For Mendix 10.18 and later, setting the ApplicationRootUrl to a `http://` URL will take precedence over the `X-Forwarded-Proto` and `X-Forwarded-Schema` headers.
59-
{{% /alert %}}
6065

66+
* For Mendix versions prior to Mendix 10.18, setting the [ApplicationRootUrl](/refguide/custom-settings/#applicationrooturl-section) runtime setting to an `https://` URL will not make the application aware of it being served via HTTPS. You must use the `X-Forwarded-Proto` and `X-Forwarded-Schema` headers instead.
67+
68+
* For Mendix versions 10.18 and later, setting the [ApplicationRootUrl](/refguide/custom-settings/#applicationrooturl-section) runtime setting to an `http://` URL will take precedence over the `X-Forwarded-Proto` and `X-Forwarded-Schema` headers.
69+
{{% /alert %}}
6170

6271
## Main Domain Name
6372

0 commit comments

Comments
 (0)