Notifications

By default, when runs finish, you will be notified by email about failed project runs. You and your project collaborators can also receive notifications about successful runs.

On successful runs, you will receive an email with the last few lines of stdout, and up to 10 Results files from your run. Domino detects which files were added or changed during your run, and captures those as the run’s Results.

You can edit your notification preferences at Projects > <your project> > Settings > Collaborations and permissions:

notifications

Custom Notifications

To format a success email to show your figures with more context, create a file named email.html in the root of your project folder as part of your run. The HTML can be used as the body and subject of the email sent on success.

Tips and tricks:

To include images, reference the path to the image from the root of the folder. The image can be anywhere in your project. For example, to include an image in plots/plot1.png, write <img src="plots/plot1.png">.
Put all CSS styles in inline style attributes. Most email clients ignore <style> blocks in HTML emails.
Use tables for complex layouts. Most email clients ignore CSS positioning.

Include the <head> and <title> tags at the start of the HTML file to customize the subject. For example: <head><title>Custom Subject</title></head> creates an email with the subject "[Domino] Custom Subject".

To explicitly define the files that are sent with your success email, create a file named .dominoresults and write a filename per line in the .dominoresults file.

Caution
If you create a .dominoresults file, you must list email.html in this file to ensure that your custom email is used. If you don’t, the default results email will be generated.

Example of an R script and the resulting email:

# generate and save plot
png("pressure.png")
plot(pressure)
dev.off()

# generate HTML in a string
html_string <- paste0("
<head>
  <title>",Sys.Date()," - Pressure report","</title>
</head>
<body>
  <h2>Exponential pressure growth! </h2>
  <h3>",Sys.time(),"</h3>
  <img src='pressure.png' />
  <p>Caption goes here</p>
</body>
")

# write string to file
write(html_string, "email.html")

notification result email