From bbfe345758fa0bc7b3bebdec04ef9390681998ff Mon Sep 17 00:00:00 2001 From: Suguru Hirahara Date: Sat, 6 Dec 2025 00:29:14 +0900 Subject: [PATCH] Update faq.md: add the section about coturn errors Signed-off-by: Suguru Hirahara --- docs/faq.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) 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?