Skip to content

Commit

Permalink
Add more documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
s-thom committed Feb 7, 2021
1 parent f7bea5b commit 093ecba
Showing 1 changed file with 13 additions and 4 deletions.
17 changes: 13 additions & 4 deletions docs/configuring-playbook-nginx.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,14 +62,23 @@ matrix_nginx_proxy_access_log_enabled: false

## Additional configuration

<!-- TODO: Introductory blurb -->
This playbook also allows for additional configuration to be applied to the nginx server.

<!-- TODO: Add section for including config files, however that's done -->

Make sure that you have set the DNS configuration for the domains you want to include to point at your server.
If you want this playbook to obtain and renew certificates for other domains, then you can set the `matrix_ssl_additional_domains_to_obtain_certificates_for` variable. Make sure that you have set the DNS configuration for the domains you want to include to point at your server.

```yaml
matrix_ssl_additional_domains_to_obtain_certificates_for:
- domain.one.example
- domain.two.example
```

You can include additional nginx configuration by setting the `matrix_nginx_proxy_proxy_http_additional_server_configuration_blocks` variable.

```yaml
matrix_nginx_proxy_proxy_http_additional_server_configuration_blocks:
- |
# These lines will be included in the nginx configuration.
# This is at the top level of the file, so you will need to define all of the `server { ... }` blocks.
- |
# For advanced use, have a look at the template files in `roles/matrix-nginx-proxy/templates/nginx/conf.d`
```

0 comments on commit 093ecba

Please sign in to comment.