Configuring Email Notifications

This documentation is for an older version of CCC. You can find the latest version here.
Last updated on January 4, 2024

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. Click Settings in the CCC toolbar.
  2. Click the Email Settings button in the toolbar of the Settings 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 in your backup task

Close the Settings window, then select the task to which you would like to add email notifications. Click the Advanced Settings button at the bottom of the window, then select the Postflight tab to reveal the email notification option. 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 address(es) 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 Task menu to save the changes.

Sending email with an SMTP service that requires an App Password

Because CCC sends emails from a background application, possibly when no user is logged in at all, CCC cannot practically support two-factor authentication. Many applications have this same logistical constraint, and most email providers will allow those applications to use the SMTP service, provided that you have created an application-specific password for that purpose. If you attempted to send an email with your Gmail or iCloud account (for example), and you get an error that "the username and password are invalid", or that "authentication failed", you can resolve the problem by creating an App Password.

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.
  4. Note: Be sure to use an @mac.com, @me.com, or @icloud.com email address for the user name.

Apple's reference: Using app-specific passwords

Ventura users: macOS 13.5 introduces a bug in Safari that prevents it from correctly generating App Passwords. Workaround: use a different browser on macOS 13.5 to generate App Passwords.

Visit your Account Security 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 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.

Visit your AT&T Profile page to generate an application-specific password for CCC. AT&T does not use the industry standard term "app-specific password" and instead calls this a "secure mail key":

  1. Visit your AT&T Profile and choose Sign-in info.
  2. Select the email account that needs a secure mail key. (You’ll find a menu at the top if you have multiple accounts.)
  3. Scroll to Secure mail key and select Manage secure mail key.
  4. Choose the email address that you’d like to use if you have more than one.
  5. Select Add secure mail key and then enter a nickname for the secure mail key to make it easier to recognize (Like "CCC").
  6. Choose Create secure mail key.
  7. Select Copy secure mail key to clipboard
  8. Paste the application-specific password into the Email Settings panel of CCC's Preferences window.

Create a secure mail key, Set up or update AT&T email - Apple Mail (OS X)

Visit your Gmail 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.
  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. Note: Be sure to use an @gmail.com email address for the user name. G Suite accounts are not supported.

Google's reference: Sign in using App Passwords

 

Visit your Outlook.com App Passwords page to generate an application-specific password for CCC:

  1. Go to the Security basics page and sign in to your Microsoft account.
  2. Select More security options.
  3. Under App passwords, select Create a new app password. A new app password is generated and appears on your screen
  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.

Microsoft's reference: 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. 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 Settings window.

Update your SMTP credentials after migrating to new Mac

When you provide your SMTP credentials to CCC, CCC stores them securely in a macOS Keychain file. That keychain file is secured in several ways; it is readable only by the macOS system administrator account, it can only be unlocked by CCC, and it can only be unlocked on the Mac upon which it was originally created. As a result, if you purchase a new Mac and migrate your data to the new Mac, CCC's keychain will not work on the new system and CCC will be unable to send email notifications.

After migrating to a new system, open CCC's Email Settings, click the Edit... button, then re-enter your SMTP account credentials.

How can I remove older email accounts listed in CCC's Email Accounts popup menu?

CCC collects email account information from the macOS Accounts service dynamically when you open the Settings window. The email accounts listed under the "macOS SMTP Accounts" heading are not email accounts that CCC retains within its own preferences, rather those come from the Accounts Preference Pane in the System Settings application. These accounts can't be removed from within CCC – again, because CCC doesn't retain information about these accounts. If you would like to remove these accounts from your Mac, you can remove them in the Internet Accounts panel in the System Settings application.