Enable email service

Last modified: 27 March 2025

By default, emails are not enabled and email verification for users is disabled. To enable the email service, specify the following parameters in the docker-compose file:

Outgoing mail configuration

Name

Type

Default value

Description

MAIL_SENDER_EMAIL

String

Not defined

Sender's email: the email address Datalore will use as "From".

MAIL_SENDER_NAME

String

Not defined

Sender's name

MAIL_SENDER_USERNAME

String

Not defined

Username of SMTP user

MAIL_SENDER_PASSWORD

String

Not defined

Password of SMTP user

MAIL_SMTP_SERVER

String

Not defined

SMTP server host

MAIL_SMTP_PORT

String

Not defined

SMTP server port

MAIL_ENABLE_STARTTLS

Boolean

false

Refer to Using TCP keepalive under Linux, tcp_keepalive_probes variable.

FORCE_EMAIL_VERIFICATION

Boolean

true

Enables new user notification emails. Users are automatically verified if this variable is set to false.

EMAIL_ALLOWLIST_ENABLED

Boolean

false

Enable a whitelist for new user registration. Only users with whitelisted emails can be registered. The respective tab is available on the Admin panel

Example

services:
  datalore:
    ...
    environment:
      ...
      MAIL_SMTP_SERVER: "email-smtp.your_domain.com"
      MAIL_SMTP_PORT: "465"
      MAIL_SENDER_USERNAME: "email_user"
      MAIL_SENDER_PASSWORD: "pa$$w0rd"
      MAIL_SENDER_EMAIL: "no_reply.datalore@you_domain.com"
      MAIL_SENDER_NAME: "Datalore Team"
      FORCE_EMAIL_VERIFICATION: "false"