Enable the email service

To enable email verification for new users or to limit what users can register, you can configure your Datalore On-Premises instance to send emails through an external SMTP server.

By default, the email service is disabled and verification emails are not sent.

Enable and configure the email service

To enable the email service, specify the following parameters under environment in the docker-compose file:

To enable the email service, specify the following parameters under dataloreEnv in the datalore.values.yaml file:

MAIL_SMTP_SERVER

String

SMTP server host

Default: not defined

MAIL_SMTP_PORT

String

SMTP server port

Default: not defined

MAIL_SMTP_TIMEOUT

Integer

Maximum time in ms to wait for a response from the SMTP server after sending a command

Default: 600000 (10 minutes)

MAIL_SMTP_CONNECTION_TIMEOUT

Integer

maximum time in ms to wait when establishing the initial connection to the SMTP server

Default: 600000 (10 minutes)

MAIL_SENDER_EMAIL

String

Sender’s email that Datalore will use in the From field

Default: not defined

MAIL_SENDER_NAME

String

Sender’s name

Default: not defined

MAIL_SENDER_USERNAME

String

Username of the SMTP user

Default: not defined

MAIL_SENDER_PASSWORD

String

Password of the SMTP user

Default: not defined

MAIL_ENABLE_STARTTLS

Boolean

See the tcp_keepalive_probes variable in the TCP Keepalive HOWTO

Default: false

FORCE_EMAIL_VERIFICATION

Boolean

Enables verification emails for new users.

If false, emails of new users are automatically considered verified.

Default: true

EMAIL_ALLOWLIST_ENABLED

Boolean

Restricts new user registrations to emails or domains from the allowlist.

You can manage the email allowlist in the Admin panel.

Default: false

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"
       FORCE_EMAIL_VERIFICATION: "false"
    

dataloreEnv:
  ...
  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"
  FORCE_EMAIL_VERIFICATION: "false"
       

11 September 2025