Setting Up a Mail Session for the Confluence Distribution

Still need help?

The Atlassian Community is here for you.

Ask the community

The simplest way to set up a mail server through the Confluence Administration console. See Configuring a Server for Outgoing Mail.

If you want to add different options or parameters you can also set up a mail session for the Confluence distribution. In the example below we'll set up Gmail.

To set up a mail session for the Confluence distribution:

  1. Stop Confluence.
  2. Move (don't copy) mail-x.x.x.jar from <confluence-install>\confluence\WEB-INF\lib to <confluence-install>\lib (x.x.x. represents the version numbers on the jar files in your installation).
    Don't leave a renamed backup of the jar files in \confluence\WEB-INF\lib. Even with a different file name, the files will still be loaded as long as it remains in the directory.
  3. Edit the <confluence-install>\conf\server.xml file and add the following at the end of the Confluence <context> tag, just before </Context>.
    Note: you're editing the <context> tag that contains the Confluence context path, not the one that contains the Synchrony context path.

    <Resource name="mail/GmailSMTPServer"
  4. Restart Confluence.
  5. Go to  > General Configuration > Mail Servers.

  6. Choose either Edit an existing configuration, or Add a new SMTP mail server.
  7. Edit the server settings as necessary, and set the JNDI Location as:


    Note that the JNDI Location is case sensitive and must match the resource name specified in server.xml.

  8. Save your changes and send a test email.

Last modified on Mar 7, 2019

Was this helpful?

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