This page last changed on Apr 11, 2011 by pwatson.

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

You can personalise email notifications by configuring the 'From' field to include the name and email address of the Confluence user who made the change.

Info 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':

    • Choose Browse > 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.
      Info 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).
      Tick 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.

      Info 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 (not copy) 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
No content found for label(s) mail-configuration.
Document generated by Confluence on Sep 19, 2011 02:39