diff --git a/docs/faq.md b/docs/faq.md index 898a1c1f6..3e7c9767d 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -440,6 +440,19 @@ To prevent double-logging, Docker logging is disabled by explicitly passing `--l See [this section](maintenance-and-troubleshooting.md#how-to-see-the-logs) on the page for maintenance and troubleshooting for more details to see the logs. +### The server fails to start due to the `Unable to start service matrix-coturn.service` error. Why and how to solve it? + +The error is most likely because Traefik cannot obtain SSL certificates due to certain reasons such as wrong domain name configuration or port 80 being unavailable due to other services. + +If Traefik fails to obtain an SSL certificate for domain names such as `matrix.`, Traefik Certs Dumper cannot extract the SSL certificate out of there, and coturn cannot be started and the error occurs. Refer to these comments for details: + +- +- + +If you are not sure what the problem is, at first make sure that you have set the "base domain" (`example.com`, **not `matrix.example.com`**) to `matrix_domain`. You should be able to find it at the top of your `vars.yml`. + +If it is correctly specified, look Traefik's logs (`journalctl -fu matrix-traefik.service`) for errors by Let's Encrypt for troubleshooting. + ## Miscellaneous ### I would like to see this favorite service of mine integrated and become available on my Matrix server. How can I request it?