matrix-docker-ansible-deploy/examples/reverse-proxies/nginx/README.md

# Nginx reverse-proxy fronting the playbook's integrated Traefik reverse-proxy

This directory contains a sample config that shows you how to use the [nginx](https://nginx.org/) webserver to front the integrated [Traefik](https://traefik.io/) reverse-proxy webserver with another reverse-proxy.


## Prerequisite configuration

To get started, first follow the [front the integrated reverse-proxy webserver with another reverse-proxy](../../../docs/configuring-playbook-own-webserver.md#fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-proxy) instructions and update your playbook's configuration (`inventory/host_vars/matrix.example.com/vars.yml`).


## Using the nginx configuration

Copy the [matrix.conf](matrix.conf) file to your nginx server's filesystem, modify it to your needs and include it in your nginx configuration (e.g. `include /path/to/matrix.conf;`).

This configuration **disables SSL certificate retrieval**, so you will **need to obtain SSL certificates manually** (e.g. by using [certbot](https://certbot.eff.org/)) and set the appropriate path in `matrix.conf`. In the example nginx configuration, a single certificate is used for all subdomains (`matrix.example.com`, `element.example.com`, etc.). For your setup, may wish to change this and use separate `server` blocks and separate certificate files for each host.

Also note that your copy of the `matrix.conf` file has to be adapted to whatever services you are using. For example, remove `element.example.com` from the `server_name` list if you don't use [Element](../../../docs/configuring-playbook-client-element.md) web client or add `dimension.example.com` to it if you do use the [Dimension](../../../docs/configuring-playbook-dimension.md) integration manager.
Improve wordng in examples/nginx/README.md 2023-02-27 15:45:28 +00:00			`# Nginx reverse-proxy fronting the playbook's integrated Traefik reverse-proxy`
add: nginx example conf + readme for fronting playbooks traefik with own nginx 2023-02-27 14:34:37 +00:00
add example Caddyfile for fronting Traefik, mark the old one as deprecated and update READMEs 2023-05-25 20:45:09 +00:00			`This directory contains a sample config that shows you how to use the [nginx](https://nginx.org/) webserver to front the integrated [Traefik](https://traefik.io/) reverse-proxy webserver with another reverse-proxy.`
add: nginx example conf + readme for fronting playbooks traefik with own nginx 2023-02-27 14:34:37 +00:00

Improve wordng in examples/nginx/README.md 2023-02-27 15:45:28 +00:00			`## Prerequisite configuration`

Replace <your-domain> with example.com Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org> 2024-10-17 13:19:28 +00:00			To get started, first follow the [front the integrated reverse-proxy webserver with another reverse-proxy](../../../docs/configuring-playbook-own-webserver.md#fronting-the-integrated-reverse-proxy-webserver-with-another-reverse-proxy) instructions and update your playbook's configuration (`inventory/host_vars/matrix.example.com/vars.yml`).
Improve wordng in examples/nginx/README.md 2023-02-27 15:45:28 +00:00

			`## Using the nginx configuration`

fix: add missing word 2023-04-17 08:09:24 +00:00			Copy the [matrix.conf](matrix.conf) file to your nginx server's filesystem, modify it to your needs and include it in your nginx configuration (e.g. `include /path/to/matrix.conf;`).
Improve wordng in examples/nginx/README.md 2023-02-27 15:45:28 +00:00
Replace DOMAIN with example.com Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org> 2024-10-17 13:17:56 +00:00			This configuration disables SSL certificate retrieval, so you will need to obtain SSL certificates manually (e.g. by using [certbot](https://certbot.eff.org/)) and set the appropriate path in `matrix.conf`. In the example nginx configuration, a single certificate is used for all subdomains (`matrix.example.com`, `element.example.com`, etc.). For your setup, may wish to change this and use separate `server` blocks and separate certificate files for each host.
Improve wordng in examples/nginx/README.md 2023-02-27 15:45:28 +00:00
Edit user identifier example (domain.com → example.com) Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org> 2024-10-10 13:15:01 +00:00			Also note that your copy of the `matrix.conf` file has to be adapted to whatever services you are using. For example, remove `element.example.com` from the `server_name` list if you don't use [Element](../../../docs/configuring-playbook-client-element.md) web client or add `dimension.example.com` to it if you do use the [Dimension](../../../docs/configuring-playbook-dimension.md) integration manager.