= JavaMailSession Configuration
:index-group: Configuration
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published


A JavaMailSession can be declared via xml in the
`<tomee-home>/conf/tomee.xml` file or in a `WEB-INF/resources.xml` file
using a declaration like the following. All properties in the element
body are optional.

[source,xml]
----
<Resource id="myJavaMailSession" type="jakarta.mail.Session">
</Resource>
----

Alternatively, a JavaMailSession can be declared via properties in the
`<tomee-home>/conf/system.properties` file or via Java VirtualMachine
`-D` properties. The properties can also be used when embedding TomEE
via the `jakarta.ejb.embeddable.EJBContainer` API or `InitialContext`

[source,properties]
----
myJavaMailSession = new://Resource?type=jakarta.mail.Session
----

Properties and xml can be mixed. Properties will override the xml
allowing for easy configuration change without the need for $\{} style
variable substitution. Properties are not case-sensitive. If a property
is specified that is not supported by the declared JavaMailSession a
warning will be logged. If a JavaMailSession is needed by the
application and one is not declared, TomEE will create one dynamically
using default settings. Multiple JavaMailSession declarations are
allowed. # Supported Properties

Property

Type

Default

Description
