chore: Allow configuring a separate mail domain

docs/ci.md

@@ -17,11 +17,12 @@ The project includes a `.gitlab-ci.yml` that allows you to execute the deploymen
 
 When starting the pipeline through the GitLab UI, you will be queried for some variables plus the following ones:
 
-- `DOMAIN`: Primary domain for your deployment making the openDesk services available e.g. as `https://portal.DOMAIN`.
-- `MAIL_DOMAIN`: (optional) Domain for the users mail addresses, defaults to `DOMAIN`.
-- `MATRIX_DOMAIN`: (optional) Domain for the users Matrix IDs, defaults to `DOMAIN`.
-- `NAMESPACE`: Namespace of your K8s cluster openDesk will be installed to.
-- `MASTER_PASSWORD_WEB_VAR`: Overwrites value of `MASTER_PASSWORD`.
+When starting the pipeline through the GitLab UI, you will be queried for some variables plus the following ones:
+
+- `DOMAIN` = The domain to deploy to.
+- `MAIL_DOMAIN` = The mail domain to use.
+- `NAMESPACE`: Defines into which namespace of your K8s cluster openDesk will be installed
+- `MASTER_PASSWORD_WEB_VAR`: Overwrites value of `MASTER_PASSWORD`
 
 Based on your input, the following variables will be set:
 - `MASTER_PASSWORD:`: `MASTER_PASSWORD_WEB_VAR`. If `MASTER_PASSWORD_WEB_VAR`

docs/getting-started.md

@@ -92,6 +92,20 @@ or via environment variable
 export DOMAIN=domain.tld
 ```
 
+If the mail domain differs from the domain, the mail
+domain has to be set either via `dev` environment
+
+```yaml
+global:
+  mail_domain: "open.desk"
+```
+
+or via environment variable
+
+```shell
+export MAIL_DOMAIN=open.desk
+```
+
 ### Apps
 
 All available apps and their default value can be found in `helmfile/environments/default/workplace.yaml`.