a001fc1b57
https://linear.app/unleash/issue/SR-173/discussion-question-notification-from-email-doesnt-work Adds a troubleshooting guide for [email service](https://docs.getunleash.io/using-unleash/deploy/email-service), which includes some knowledge shared in this discussion: https://github.com/orgs/Unleash/discussions/5323#discussioncomment-7554431
2.0 KiB
| title |
|---|
| The email service is not working correctly on my self-hosted Unleash instance |
When setting up your self-hosted Unleash instance, one of the available options is to configure an email service that will allow Unleash to send reset password and welcome emails to users.
Here's how to troubleshoot some common issues related to the email service.
Configuration
The most common issues arise from misconfiguration. Please refer to the following documentation for guidance:
You should double check that the details in your configuration look correct.
Invalid URL error
Make sure that the UNLEASH_URL variable is correctly set to a valid URL. This should be set to the public discoverable URL of your Unleash instance, and it should include the protocol (http or https).
Examples:
- Subdomain:
https://unleash.mysite.com - Subpath:
https://mysite.com/unleash
SSL-related errors
SMTP TLS port
Please double check that you're trying to reach your SMTP server on the TLS port, typically 587.
Custom SSL certificate
If you're using your own SMTP server which uses a custom SSL certificate, you will need to tell Unleash to trust that certificate. You can do this by setting the NODE_EXTRA_CA_CERTS variable to the path of the certificate file.
This is usually done by mounting the custom certificate in a volume, and then setting NODE_EXTRA_CA_CERTS to the absolute path in the container where it can find the certificate. For example, if you mount it to /var/certs, you should set NODE_EXTRA_CA_CERTS to something like /var/certs/mycert.crt.