Skip to content

Notifications

SMTP (Simple Mail Transfer Protocol) is a network protocol used for sending email messages.

Configuring

The SMTP client is disabled by default. To enable it, configure the following environment variables of the backend service.

Environment variable Description
SMTP_USERNAME SMTP client username
SMTP_PASSWORD SMTP client password
SMTP_ADDRESS SMTP client address in host:port or ip:port format. The choice of port number determines whether TLS is used:
1. 25 port — without TLS (not recommended).
2. 587 port — Using STARTTLS (recommended)

Important

If the environment variables are not set, SMTP client logs will not be created.

Checkout

To debug message sending, the backend must be started with the LOG_LEVEL environment variable set to debug.

  • Example of a log produced when a debug message is sent:

    2026-02-09T16:37:54.135274+03:00    DEBUG    server.api.smtpClient    New email    {"From": "smtp.solidlab.test@yandex.ru", "To": ["ivanov.ivan@solidlab.ru"], "Message": "MIME-version: 1.0;\nContent-Type: text/plain; charset=\"UTF-8\";\r\nContent-Transfer-Encoding: quoted-printable\r\nFrom: smtp.solidlab.test@yandex.ru\r\nTo: ivanov.ivan@solidlab.ru\r\nSubject: Registration for SolidPoint\r\n\r\n\nIvan, welcome to SolidPoint\n\nPlease wait until your organization’s administrator activates your account.\n\nYou are receiving this email because your email address was used to register for the SolidPoint dashboard. If this was not you, please ignore this message.\n\r\n"}

The following errors may occur if the SMTP client is configured and attempts to send a message:

  • SMTP client authentication error:

    2026-02-09T16:34:58.031329+03:00    ERROR    server.api.smtpClient    Failed to send email    {"error": "535 5.7.8 Error: authentication failed: Invalid user or password! 1770644098-vYR1awSGCOs0"}

    Possible causes:

    1. Invalid authentication data.

  • Host error when sending an email via the SMTP client:

    2026-02-09T16:36:22.502438+03:00    ERROR    server.api.smtpClient    Failed to send email    {"error": "dial tcp: lookup smtp..ru: no such host"}

    Possible causes:

    1. Incorrect SMTP client address specified.
    2. DNS issues.
    3. No network connection.