> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/settings/general/smtp.md).

# SMTP

<figure><img src="/files/gxBIWUKB15azHJ6Jj9qb" alt=""><figcaption></figcaption></figure>

The **SMTP Settings** section allows you to configure an email server used by Gaio DataOS to send system notifications, alerts, and transactional messages (such as user invitations, password resets, and system events). This configuration is **global per project** and must be enabled for email delivery to work.

## Accessing SMTP Settings

1. Insert the address of your SMTP server, such as `smtp.office365.com` , `smtp.gmail.com`,etc.
2. Configure the SMTP port used by your provider.
3. Defines the encryption method used for the SMTP connection (TSL or SSL).
4. Create a display name that will appear as the sender of system emails.
5. Insert the email account used to authenticate with the SMTP server.
6. Insert the password associated with SMTP user.

{% hint style="info" %}
When using **Microsoft / Office 365 SMTP**, enable this option. This applies Microsoft-specific handling and compatibility settings for authentication.
{% endhint %}

7. Turns SMTP delivery on or off.
   * When **enabled**, Gaio will attempt to send emails using the configured server
   * When **disabled**, no system emails will be sent

### Testing the SMTP Connection

Before saving, always validate your configuration:

1. Click **Test SMTP Connection**
2. Gaio will attempt to authenticate and send a test message
3. If successful, the configuration is ready for use
4. If it fails, review:
   * Host and port
   * Encryption type
   * Credentials
   * Firewall or email provider restrictions

### Saving the Configuration

After a successful test:

1. Click **Save**
2. The SMTP configuration becomes active immediately
3. All system notifications will start using this email server

### Common SMTP Providers

| Provider   | Host                      | Port | Encryption |
| ---------- | ------------------------- | ---- | ---------- |
| Office 365 | smtp.office365.com        | 587  | TLS        |
| Gmail      | smtp.gmail.com            | 587  | TLS        |
| SendGrid   | smtp.sendgrid.net         | 587  | TLS        |
| Amazon SES | email-smtp..amazonaws.com | 587  | TLS        |