​

Email

OpenMetadata sends email for several purposes:

• Team invites
• Task and conversation notifications
• Alerts
• Scheduled reports

None of that mail goes out until an admin points OpenMetadata at a working SMTP server, so this is one of the first settings to configure on a new instance if you want invited teammates to actually receive their invite emails. The Email page under Preferences configures the SMTP server used to send all of these.

​

Configure Email

1. Navigate to Settings > Preferences > Email.
2. Click Edit.
3. Configure the following fields:

   Field	Description
   Username	SMTP account username
   Password	SMTP account password
   Sender Email	Required. The “from” address on outgoing mail. Can be the same as Username, though some providers, such as Amazon SES, use a different value for each
   Server Endpoint	Required. Hostname of the SMTP server, for example smtp.gmail.com
   Server Port	Required. Port the SMTP server listens on. The port you use determines which Transportation Strategy to select below
   Emailing Entity	Name shown as the sender in outgoing emails, for example your organization name. Default: OpenMetadata
   Enable SMTP Server	Turns SMTP sending on or off. When off, OpenMetadata doesn’t send any email
   Support URL	Link included in emails for users to reach your support team. Default: https://slack.open-metadata.org
   Transportation Strategy	Connection security mode, chosen to match Server Port

   Match Server Port to the Transportation Strategy it corresponds to:

   Server Port	Transportation Strategy
   25	SMTP
   465	SMTPS
   587	SMTP_TLS

   
4. Click Save.

​

Test Email

Use Test Email to verify the SMTP configuration works before relying on it for real notifications. This catches a wrong port, an expired password, or a blocked outbound connection immediately, instead of finding out later when an invite or an alert quietly fails to arrive:

1. From the Email settings page, click Test Email.
2. Enter a recipient address.
3. Click Test to send a one-off test message through the configured SMTP server.

A success or failure toast confirms whether the SMTP server accepted the test message.

​

OpenMetadata URL

OpenMetadata URL is a separate, single-field setting stored alongside Email configuration. It’s used to build the links inside the emails OpenMetadata sends — for example, the “view this asset” link in a task notification. If this points at the wrong address, every link in every notification email points at the wrong place, even though the emails themselves send successfully.

1. Navigate to Settings > Preferences > OpenMetadata URL.
2. Click Edit.
3. Set OpenMetadata URL to the base URL your users actually use to reach this instance. Default: http://localhost:8585, which only works for local development, so update it before you rely on email links in production.
4. Click Save.