> For the complete documentation index, see [llms.txt](https://lakm.gitbook.io/evaluator/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lakm.gitbook.io/evaluator/installation/mail-setup.md). # 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 ; 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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://lakm.gitbook.io/evaluator/installation/mail-setup.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.