# Configure SMTP

By default, the app sends emails through a built-in relay. To send from your own domain and improve deliverability, configure your own SMTP server.

***

## Steps

1. Go to **Registration → Email Settings**
2. Click **SMTP Settings** in the left sidebar
3. Fill in your SMTP credentials
4. Click **Save**
5. Click **Send test email** to verify the connection

***

## SMTP fields

| Field          | Description                            | Example                    |
| -------------- | -------------------------------------- | -------------------------- |
| **SMTP Host**  | Your mail server hostname              | `smtp.gmail.com`           |
| **SMTP Port**  | Port number                            | `587` (TLS) or `465` (SSL) |
| **Username**   | Your SMTP login                        | `you@yourdomain.com`       |
| **Password**   | Your SMTP password or app password     |                            |
| **From email** | The "From" address shown to recipients | `noreply@yourdomain.com`   |

***

## Gmail SMTP setup

1. Enable 2-factor authentication on your Google account
2. Go to Google Account → Security → App passwords
3. Generate an app password for "Mail"
4. Use:
   * Host: `smtp.gmail.com`
   * Port: `587`
   * Username: your Gmail address
   * Password: the generated app password

***

## If you don't configure SMTP

Emails are still sent through the app's default relay. This works out of the box but emails may show the app's sender domain instead of yours.

***

## Troubleshooting

If the test email fails:

* Double-check your host, port, and credentials
* For Gmail: make sure you're using an **App Password** (not your regular Gmail password)
* Check that your mail server allows SMTP connections from external apps
* See [Emails not sending](/orbit-b2b-docs/faq-and-troubleshooting/emails.md)


---

# 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://orbit-b2b.gitbook.io/orbit-b2b-docs/email-notifications/smtp-setup.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.