This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

Configuring a Server for Outgoing Mail

Added by Vidya Madabushi, last edited by Edwin Dawson [Atlassian] on May 15, 2008  (view change) show comment
All Versions
Click for all versions
Confluence 2.9 Documentation

Index

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.

To configure Confluence Standalone to send outgoing mail,

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

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administration Console' view will open.
  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).
    • Name: By default, this is set to 'SMTP Server'.
    • From: Enter the email address that will be displayed in the 'from' field for email messages originating from this server.
    • Subject Prefix: Enter a subject prefix, if required.
  4. Configuring the Host Address, Username and Password:
    • Manually enter your 'Host Address', 'Username' 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. javamail-x.x.x.jar
  2. activation-x.x.x.jar
  3. mail-x.x.x.jar

Ideally, these should be:

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

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

Standalone Version: Please move the above three jar files from the confluence/WEB-INF/lib directory to the common/lib directory and restart Confluence.

RELATED TOPICS
Configuring a Server for Outgoing Mail
Enabling the 'Mail Page' plugin
The Mail Queue

Labels:

mail-configuration mail-configuration Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.

Comments (6)

 

  1. Oct 08, 2007

    Alfred Nathaniel says:

    Mail sending does not work in standalone Confluence 2.6.0.&nbsp; Tomcat 5.5.23 b...

    Mail sending does not work in standalone Confluence 2.6.0.  Tomcat 5.5.23 bundled with it is lacking org.apache.naming.factory.MailSessionFactory and a few other classes (see http://issues.apache.org/bugzilla/show_bug.cgi?id=40668).

     To fix it, owerwrite common/lib/naming-factory.jar with the version from Tomcat 5.5.25.

  2. Jan 16, 2008

    Anonymous says:

    I also can confirm that you need to replace the bundled common/lib/namingfactory...

    I also can confirm that you need to replace the bundled common/lib/naming-factory.jar with the version from Tomcat 5.5.25

    I am using Confluence 2.7 running the bundled Apache Tomcat/5.5.23  (Confluence installer downloaded on 10th Jan 2008).

    This was an upgrade so I *knew* I had correctly configured the server.xml and web.xml files, and I had moved the 3 files as described in the instructions (in fact, I think javamail-1.3.2.jar  was missing from WEB-INF/lib in the 2.7 bundle) - I copied it over from my Confluence 2.5.1 install directory.

    I downloaded the Tomcat 5.5 zip (link below) to extract common/lib/naming-factory.jar and replace the bundled one in confluence-2.7-std/common/lib/

    http://archive.apache.org/dist/tomcat/tomcat-5/v5.5.17/bin/apache-tomcat-5.5.17.zip

  3. Jul 27

    Mark Rothfield says:

    How do you change the time of day and email subject line for the daily update em...

    How do you change the time of day and email subject line for the daily update email?

    1. Jul 28

      Azwandi Mohd Aris says:

      Hi Mark, Please ensure that you have a backup of every files that you are going...

      Hi Mark,

      Please ensure that you have a backup of every files that you are going to modify in the following steps.

      To change the time of day for the daily email report, please refer to a similar documentation at:

      The id of the bean, in this case should be dailyReportTrigger, instead of backupTrigger in the documentation.

      To change the email subject line to something else, please refer to the following page:

      The name of the parameter that you need to change is daily.report.title.

      Remember to restart your Confluence in order for the changes to take effect. Hope this helps.

      Cheers,
      Azwandi

  4. Aug 14

    Anonymous says:

    Hi \\ We are using WIKI space . We want to&nbsp;send&nbsp; email through WIKI pa...

    Hi

    We are using WIKI space . We want to send  email through WIKI page to our group when we upload any doc on that wiki page.

    Regards,

    Varinder Singh

    Senior Engineer 

    1. Aug 14

      Ming Giet Chong says:

      Hi Varinder, You may want get your users to Watch the page/Space to receive not...

      Hi Varinder,

      You may want get your users to Watch the page/Space to receive notification on content changes. Please see the following link for more options on tracking updates:

      Regards,
      MG

Add Comment