# Mail Setup

The evaluator can work without an email setup, but we highly recommend enabling it.

### Why Do I Need to Configure Email?

Evaluators use a unique code for candidates to access the questionnaire. Email is the most effective method for delivering this code to the relevant candidates, allowing them to start the quiz conveniently. Otherwise, site administrators would need to find alternative ways to share the code, such as communicating it manually.

### Prerequisites

* Email account

### **Configure Mail Account**

Setting up an email account is very easy. All you need to do is configure the correct mail settings in the [**.env**](/evaluator/miscellaneous/.env.md) file.

Open the **.env** file, locate the mail configuration section, and fill in the values as shown below.

```
MAIL_DRIVER="Your mail driver"           → (e.g., smtp)
MAIL_HOST="Your mail host"               → (e.g., smtp.gmail.com)
MAIL_PORT="Your mail port"               → (e.g., 587)
MAIL_USERNAME="Your email ID"            → (e.g., yourname@gmail.com)
MAIL_PASSWORD="Your email password"      → (e.g., your email account password)
MAIL_ENCRYPTION="Your encryption type"   → (e.g., tls or ssl)
```

* **MAIL\_DRIVER:** Usually set as **smtp**
* **MAIL\_HOST:** For Gmail it is **smtp.gmail.com**, for others it could be **smtp.sendgrid.net**, etc.
* **MAIL\_PORT:** Common values are **587**, **465**, or **2525**, depending on your email provider
* **MAIL\_USERNAME:** The email ID used to send emails from your app
* **MAIL\_PASSWORD:** The actual password or app-specific password of your email
* **MAIL\_ENCRYPTION:** Usually **tls** or **ssl** (used to secure the connection)

If the email address is <evaluator@gmail.com>; values must be filled as following

```
MAIL_DRIVER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=evaluator@gmail.com
MAIL_PASSWORD=yourpassword
MAIL_ENCRYPTION=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://lakm.gitbook.io/evaluator/installation/mail-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.