Configuring Email Notifications

This article is for an older version of CCC. You can find the latest version here.
Printer-Friendly Version
Product: 
ccc4

If you would like CCC to send your tasks' results via email, you must first configure a sending email account in CCC's Email Settings.

  1. Choose Preferences from the Carbon Copy Cloner menu (or click the Preferences button in the toolbar).
  2. Click the Email Settings button in the toolbar of the Preferences window.
  3. Choose from one of the accounts imported from Mail in the Sent From Email popup menu, then verify the details and provide your account credentials in the form that is provided.
  4. Click the OK button when you are finished entering your account details.

Note for advanced users: If your SMTP server requires SSL and uses a self-signed security certificate, check the Don't validate the certificate chain checkbox. Alternatively, you can add your server's security certificate to the System keychain in the Keychain Access application and explicitly trust that certificate.

[Optional] Modify the email subject and body template

The subject and body of the email that CCC sends upon task completion can be customized. For example, if you want to know which of your Mac's a particular email is coming from, you could customize the subject of the message:

    Jon's iMac: ##Task Name##: ##Exit Status##

When CCC sends an email notification, it will replace the template values (enclosed in double # characters) with the attributes of your task, e.g.:

    Jon's iMac: Daily Backup: Backup Finished Successfully

Most of the available template values are already present in the default template. You can rearrange the template values and modify the text around them, but do not modify the text inside of the double # characters. If you would like to add a template value:

  1. Place the cursor where you would like to place the template value, e.g. in the subject or body text field.
  2. Select a template value from the Template values popup menu.
  3. Click the Insert button.

When you are finished making changes to your subject and body templates, click on the Save Changes button. This template will be used for all email notifications sent by CCC.

If you have suggestions for additional template values, please let us know!

Send a test email

Click on the Send Test Email... button at the bottom of the window. You will be prompted to provide an email address to send the test email to. When CCC indicates that the test email has been sent, check your email to confirm that you can receive it and that the template provides the information you wish to receive when your tasks complete.

Select a notification level

Close the Preferences window, then select the task to which you would like to add email notifications. There are three notification levels:

  • Don't send email: CCC will never send an email when this tasks finishes.
  • Send after every run: CCC will send an email at the end of every task (i.e. successful tasks and those that report errors).
  • Only send on errors: CCC will send an email only when errors occur for this task.

Select a notification level, then specify the email addresses that you would like CCC to notify when the task completes. If you would like to have emails sent to multiple addresses, separate those addresses with a comma, or simply press the return key after typing in each address. The recipient text field may only show one address at a time. Use the arrow keys to see each address.

Once you have configured a notification level and recipients, choose Save from CCC's File menu to save the changes.

Sending email with an SMTP account that requires two-step verification

If you have enabled two-step or two-factor verification on your iCloud or Gmail account, CCC will not be able to immediately send emails using that account. When attempting to send an email with that account, you will receive an error indicating that the username and password are invalid, or that authentication failed.

June 15, 2017: Apple Policy Change

Starting on June 15, 2017, Apple no longer permits third-party applications to send email via iCloud without the use of an application-specific password. That means that to use an iCloud account to send emails via CCC, you must enable two-factor or two-step authentication on your iCloud account and create an app-specific password.

Solution: iCloud with two-factor or two-step authentication

Apple does not currently extend support to third-party developers for their two-step/two-factor authentication mechanism. If you have enabled two-step or two-factor authentication on your Apple ID, visit your Apple ID account page and create an application-specific password for CCC:

  1. Sign in to your Apple ID account page.
  2. In the Security section, click the Generate Password... link under the APP-SPECIFIC PASSWORDS heading and follow the steps provided.
  3. Paste the application-specific password into the Email Settings panel of CCC's Preferences window.

Apple's reference: Using app-specific passwords

Solution: Yahoo with two-step verification

If you have enabled two-step verification on your Gmail account, visit your App Passwords page to generate an application-specific password for CCC:

  1. Visit your Account Security page.
  2. Click on the Generate app password link at the bottom of the page.
  3. Click Select yourapp and choose Other App. Type in CCC or Carbon Copy Cloner as the custom name.
  4. Click the Generate button.
  5. Copy and paste the application-specific password into the Email Settings panel of CCC's Preferences window. Note: We recommend that you copy and paste the code. If you choose to transcribe it, take care not to insert spaces. The code is presented in four groups, but it does not actually contain spaces; it should be exactly 16 characters.

Solution: Gmail with two-step verification

If you have enabled two-step verification on your Gmail account, visit your App Passwords page to generate an application-specific password for CCC:

  1. Visit your App passwords page.
  2. Click Select app and choose Other (custom name). Type in CCC or Carbon Copy Cloner.
  3. Click the Generate button.
  4. Paste the application-specific password into the Email Settings panel of CCC's Preferences window. Note: We recommend that you copy and paste the code. If you choose to transcribe it, take care not to insert spaces. The code is presented in four groups, but it does not actually contain spaces; it should be exactly 16 characters.
  5. Click the Done button.

Google's reference: Sign in using App Passwords

"Your Gmail account will not permit CCC to send email notifications"

Google is very insistent that developers of third-party applications attain a Google Developer Account and subscribe to Google's proprietary APIs so they can use a special form of authentication with Gmail accounts (OAuth2). Developers that choose to use industry-standard authentication mechanisms instead are unjustly deemed as "less secure", and by default, Google will deny authentication requests from these applications. To add insult to injury, when an application attempts to authenticate to Gmail using the industry-standard authentication methods, Google sends you an email that suggests that the requesting application "doesn't meet modern security standards".

CCC absolutely uses modern security standards — TLS, in particular, to secure all traffic to the SMTP server. TLS has and continues to be the modern security standard for securing email communications. Rather than spend several days implementing support for Google's proprietary authentication mechanism, I have chosen to spend my precious development time improving other functionality within CCC; functionality that's core to protecting your data.

If you get a message that your Gmail account won't permit CCC to send email, we have two suggestions:

— Or —

Alternatively, you could just specify a non-Google email account in the Email Settings section of CCC's Preferences window.

Tags: