.svg?alt=media&token=ff97d6ac-c76d-45bc-af5b-04ffd317e2e2)
Comment on page
Configuring SMTP
How to configure a custom SMTP server on your self-hosted Cobrowse.io instance for sending magic link login emails via your company email.
Cobrowse supports configuring a custom SMTP server to replace the default email provider. This will allow you to use your company email to send the magic link login emails.
- 1.
- 2.Open
/admin/configurationon your instance while logged in as a superuser. e.g. https://example.com/admin/configuration - 3.Enter a new configuration key called "smtp_url". The value should be the URL of your SMTP server including any authentication or non-standard ports.
Please use the username part of the SMTP URL to change the email address seen as the sender of the email. The username should be the full email address you wish to use but it must be an address the SMTP server can send from.
smtps://[email protected]@smtp.example.com
Example SMTP URLs
A standard SMTP URL has the format
smtps://username:[email protected]If your mail server does not require authentication, you can omit the
username:password fields, e.g.smtps://smtp.example.com If your mail server does not require a TLS connection, use can use the
smtp:// protocol in the URL instead, e.g. smtp://smtp.example.comIf your mail server uses a non-standard port you can specify that via the URL, e.g.
smtp://smtp.example.com:12345During debugging it can be useful to increase console messages and reduce impacting factors.
We only recommend adding these query parameters when debugging in a test environment. We do not recommend adding any of these to your production SMTP URL.
To increase the log level add the
debug and logger query parameters to your SMTP URL.smtps://example.com?debug=true&logger=trueIt may be useful to remove any TLS validation during debugging to understand where the problem might be. To do this you can add the
rejectUnauthorized query parameter with the value of false and append port number 25 to the end of the URL.smtp://example.com:25?tls.rejectUnauthorized=falseLast modified 27d ago