Enable mail debugging mode in Confluence Data Center and Server

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the server and data center platforms.


To detail clearly how to enable debug mode for both the incoming and outgoing emails in Confluence.


This feature is only available on Confluence Server or Data Center 7.20 or later.

You need System Administrator global permissions to do this.

Change the logging level of the com.atlassian.confluence.mail.session package

  1. Go to  > General Configuration > Logging and Profiling.
  2. If you run Confluence in a cluster, select a cluster node.
  3. Locate the com.atlassian.confluence.mail.session  package, and select DEBUG value from the New Level menu.
  4. Save your changes.

Remember, your changes will not be written to the log4j.properties file and will be discarded when you next stop Confluence.

To enable email logging at the protocol level (more verbose), add -Dmail.debug=true to the Confluence System Properties.

For more information on the subject, refer to Configuring Logging on Confluence Server and Data Center.

(info) Keep in mind that the primary goal of debug logging is troubleshooting. It is good practice to disable the debug logging after the problem is solved to avoid potential performance impacts and logs with too many entries.

Last modified on Aug 20, 2022

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.