Let’s configure emails in Confluence

Emails in confluence are the core part of the system. We use them in lots of situtations but they are only the addition to the pages we create in daily actions.

In most cases we will use emails to enable us such set of actions: page share notification, password reminder, page updates. So the question from the title how to configure emails in Confluence is very well-founded.

As always any administration actions we need to start from Confluence Administration menu.

We select option General configuration and this will redirect us to the page with administrator confirmation password.

General configuration – emails in Confluence

Administrator access

All we need to do is to type the administrator password and click Confirm.

Administrator Access to define emails in Confluence

General Configuration

System should redirect us to the Confluence administration page. Click Mail Servers in the left sidebard.

Site Configuration in Confluence

Mail server page

System should redirect you to the View Mail Servers page. This page shows us a list of all configured mail servers. We will start here defining new SMTP mail server that will enable proper working of the Confluence system.

In order to add new mail server we need to click on link Add a new SMTP mail server.

View Mail Servers in Confluence

Adding new SMPT mail server

In the Create mail server page we need to fill some fields. The fields are group into two sections like below:

SMTP server details

• Name – this field is only the name of the mail server and it is used only on the list of mail servers, you can type here anything
• From address – type email in the field, this email is a send
• From name – this field is the name of the sender so ${fullname} is your full name and surname plus (Confuence), for example you will see in your mailbox that sender name is for eample like: ‘Artur Poniedziałek (Confuence)‘
• Subject prefix – the prefix type here will be the first part of every email title send by Confluence to any user in the system

Server hostname

• Hostname – here you need to type to correct mailbox server name, verify this with settings from you email provider
• Port – depending on the protocol and provider settings type your mailbox server port
• User name – in most system user name is the full email
• Password – just type password to your mailbox

If we properly configured all fields we need to click Submit button to save settings.

Configuring emails in Confluence – adding new SMTP mail

Now we can see that new SMTP mail server presents on the list of mail severs. Let’s verify the correctness of the new server mail record.

Click on Send test email link to start the test.

Added new SMTP email in Confluence

We should see Send test email page. Every fields are filled in default values. We only need to click the button Send.

Testing SMTP mail server

If we configured mail server corectly in the previous steps we should see in the log section a message:

Your test message has been sent successfully to info@bestin-it.com.

If something went wrong you will see a message with errors and you need to verify this using for example the page: https://confluence.atlassian.com/confkb/mail-troubleshooting-180847235.html

Test if emails in Confluence work properly

As a result we should be able send any notifications about new page in the system to another user.