# Mail Server

## `Site Options`

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

**`Mail Server:`**` ``This is the web address for the SMTP server.  The address for the SMTP server may be an Internet address, such as mail.company.com, or the IP address of the mail server, such as 127.0.0.1.`\
\
`If not specified, ContentBox will use the mail server address from the ColdFusion Administrator.`

**`Mail Server Username:`**` ``This is the username for the mail server, if necessary.`

`If not specified, ContentBox will use the username address from the ColdFusion Administrator.`

**`Mail Server Password:`**` ``This is the password for the mail server, if necessary.`

`If not specified, ContentBox will use the password from the ColdFusion Administrator.`

**`Mail SMTP Port:`**` ``This is the port number on which the mail server is running.  This value will default to 25.`

**`Use TLS:`**` ``This enables/disables (default) the Transport Level Security (TLS) on the connection to the mail server.`

**`Use SSL:`**` ``This enables/disables (default) SSL encryption on the connection to the mail server.`

`After you have configured the mail server settings, you can click the`` `**`Test Connection`**` ``button to send a test email message to the email address associated with the current logged in user.`

### `When running ContentBox in Development Mode:`

When running ContentBox in development mode, the mail server details are not utilized.  Instead, all emails will be written to the file system logs for review.  This prevents inadvertent emails from being sent during development.

The logs for every email sent will be located in:

`[ContentBox Root Folder]\config\logs\mail`


---

# 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://contentbox.ortusbooks.com/usage/using-contentbox/system/settings/mail-server.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.
