This page last changed on Mar 07, 2011 by ggaskell.

Configuring your Confluence server to send outgoing mail allows your Confluence users to:

You need to have System Administrator permissions in order to perform this function.

Configuring Confluence to Send Outgoing Mail

To configure Confluence to send outgoing mail:

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administrator Access' login screen will be displayed.
    • Enter your password and click 'Confirm'. You will be temporarily logged into a secure session to access the 'Administration Console'.
  2. Select 'Mail Servers' under 'Configuration' in the left panel. This will list all currently configured SMTP servers.
  3. Click 'Add New SMTP Server' (or edit an existing server).
  4. Edit the following fields as required:
    • Name: By default, this is simply 'SMTP Server'.
    • From Address: Enter the email address that will be displayed in the 'from' field for email messages originating from this server.
      This field is mandatory. You will not be able to complete the Confluence mail server configuration until this field has been specified.
    • From Name: Enter the name that will be displayed in the 'from' field for email messages originating from this server. This is the text which appears before the user's registered email address (in angled brackets).
      This field accepts the following variables, which reference specific details defined in the relevant Confluence user's profile:
      Variable Description
      ${fullname} The user's full name.
      ${email} The user's email address.
      ${email.hostname} The domain/host name component of the user's email address.

      The default is '${fullname} (Confluence)'.
      Hence, if Joe Bloggs made a change to a page he was watching and the Confluence site's 'From Address' was set to confluence-administrator@example-company.com, then the 'From' field in his email notification would be: Joe Bloggs (Confluence) <confluence-administrator@example-company.com>.

    • Subject Prefix: Enter a subject prefix, if required.
  5. Configuring the Host Address, User Name and Password:
    • Manually enter your 'Host Address', 'User Name' and 'Password' details in the form fields displayed (recommended).
      OR
    • Specify the 'JNDI location' of a mail session configured in your application server in the form field displayed.

Troubleshooting

If you experience problems with these configurations, please check that your <Confluence-Install>/confluence/WEB-INF/lib contains only one copy of the following JAR files:

  1. activation-x.x.x.jar
  2. mail-x.x.x.jar

Ideally, these should be:

  • activation-1.0.2.jar
  • mail-1.3.2.jar (or later)

You will then need to move these into the proper directory:

Standalone distribution: Please move the two jar files from the <Confluence-Install>/confluence/WEB-INF/lib directory to <confluence-install>/lib (for Confluence version 2.10 onwards) or <Confluence-Install>/common/lib (for earlier product versions) and restart Confluence.

RELATED TOPICS
Page: Configuring a Server for Outgoing Mail
Page: The Mail Queue
Page: Enabling the 'Mail Page' plugin
Document generated by Confluence on Mar 16, 2011 18:27