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

1.7 KiB

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

This directory contains a sample config that shows you how use the nginx webserver to front the integrated Traefik 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 instructions and update your playbook's configuration (inventory/host_vars/matrix.<your-domain>/vars.yml).

Using the nginx configuration

Copy the matrix.conf file to your nginx server's filesystem, modify it to your needs and include it 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) and set the appropriate path in matrix.conf. In the example nginx configuration, a single certificate is used for all subdomains (matrix.DOMAIN, element.DOMAIN, 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.domain.com from the server_name list if you don't use Element web client or add dimension.domain.com to it if you do use the Dimension integration manager.