# Email parameters and templates configuration

Use this information to configure the email services for the on-premise installation for outbound email to manage all emails sent from Tiledesk to users such as project invitations, email verification, subscriptions and notifications. Tiledesk uses [NodeMailer](https://nodemailer.com/) to send the emails.

## Enable the email subsystem

To enable the email service set the follow **env property** to true of your **tiledesk-server** component. The default value is false.

```
EMAIL_ENABLED=true
```

## SMTP configuration

The following properties can be configured for the Outbound SMTP subsystem type:

* **EMAIL\_HOST**=YOUR\_EMAIL\_HOST Specifies the host name (defaults to "localhost") of the SMTP host, that is, the host name or IP address of the server to which email should be sent.
* **EMAIL\_USERNAME**=YOUR\_EMAIL\_USERNAME Specifies the user name of the account that connects to the smtp server.
* **EMAIL\_SECURE**=true #defaults to 587 if is secure is false or 465 if true If true the connection will use TLS when connecting to server. If false (the default) then TLS is used if server supports the STARTTLS extension. In most cases set this value to true if you are connecting to port 465. For port 587 or 25 keep it false.
* **EMAIL\_PORT**=25 Is the port to connect to (defaults to 587 if is secure is false or 465 if true)
* **EMAIL\_PASSWORD**=YOUR\_SMTP\_PASSWORD Specifies the password for the user name used in EMAIL\_USERNAME.
* **EMAIL\_FROM\_ADDRESS**=FROM\_EMAIL\_ADDRESS Specifies the email address from which email notifications are sent. This setting is for emails that are not triggered by a user, for example, activity notification emails.
* **EMAIL\_BASEURL**=<https://YOOURDOMAIN.com/dashboard> This is the dashboard endpoint. Default value is : <https://panel.tiledesk.com/v3/dashboard>

## Email template configuration

In Tiledesk you can customize the emails template using the following **env variables** (multiline strings) of your **tiledesk-server** component :

* **EMAIL\_ASSIGN\_REQUEST\_HTML\_TEMPLATE** Email sent to notify a new request in the assigned mode.
* **EMAIL\_ASSIGN\_MESSAGE\_EMAIL\_HTML\_TEMPLATE** Email sent to notify a new request in the assigned mode for inbound email channel.
* **EMAIL\_POOLED\_REQUEST\_HTML\_TEMPLATE** Email sent to notify a new request in the pooled mode.
* **EMAIL\_POOLED\_MESSAGE\_EMAIL\_HTML\_TEMPLATE** Email sent to notify a new request in the pooled mode for inbound email channel.
* **EMAIL\_NEW\_MESSAGE\_HTML\_TEMPLATE** Email sent to the requester to notify a new message when the requester is offline
* **EMAIL\_TICKET\_HTML\_TEMPLATE** Email sent to the requester to notify a new message for inbound email channel.
* **EMAIL\_FOLLOWER\_HTML\_TEMPLATE** Email sent to the request follower to notify an update.
* **EMAIL\_DIRECT\_HTML\_TEMPLATE** Email sent for direct message.
* **EMAIL\_RESET\_PASSWORD\_HTML\_TEMPLATE** Email sent when a user reset the password.
* **EMAIL\_PASSWORD\_CHANGED\_HTML\_TEMPLATE** Email sent when the password is changed.
* **EMAIL\_EXUSER\_INVITED\_HTML\_TEMPLATE** Email sent when a agent invites an existing platform user.
* **EMAIL\_NEWUSER\_INVITED\_HTML\_TEMPLATE** Email sent when a agent invites a new user.
* **EMAIL\_VERIFY\_HTML\_TEMPLATE** Email sent when an agent signup on the platform.
* **EMAIL\_SEND\_TRANSCRIPT\_HTML\_TEMPLATE** If the property "Transcript by email" is enabled this email is sent automatically at the end of each chat to the requester.

You can find the default email templates under the [template/email](https://github.com/Tiledesk/tiledesk-server/tree/master/template/email) folder of the tiledesk-server project

Please refer to these guides for multi-line env variables:

* [Yaml multi-line](https://yaml-multiline.info) for Kubernetes
* [Helm multi-line control](https://helm.sh/docs/chart_template_guide/yaml_techniques/#controlling-spaces-in-multi-line-strings)


---

# 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://developer.tiledesk.com/configuration/email.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.