# 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        |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/settings/general/smtp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.