Configuring Email

Some Avalon system actions like collection creation or batch ingest send notification emails, and outbound email must be configured for these to be delivered.

Avalon can be configured to use a SMTP server or AWS SES. The examples below assume SMTP. To use AWS SES, set the mailer to :aws_sdk and ignore the rest of the properties

For a full list of available configuration options see the ActionMailer configuration documentation.

Mailer Configuration

Using Environment Variables

In your .env or docker-compose.yml set the following variables and modify as needed:

SETTINGS__EMAIL__MAILER=smtp SETTINGS__EMAIL__CONFIG__ADDRESS=mail-relay.university.edu SETTINGS__EMAIL__CONFIG__PORT=25 SETTINGS__EMAIL__CONFIG__ENABLE_STARTTLS_AUTO=false

Using Settings.yml

In your config/settings/production.local.yml or config/settings.yml file set the following properties and modify as needed:

email: mailer: :smtp config: address: mail-relay.university.edu port: 25 enable_starttls_auto: false

System Email Address Configuration

Avalon uses system email accounts to send email as well as display a support email address to users when certain problems are encountered. A single email address can be used or different email addresses can be configured to tie into existing infrastructure. The different configuration options are listed below including when they are used.

Comments

This email address receives comments submitted by users from the comments form.

Using Environment Variables

SETTINGS__EMAIL__COMMENTS=avalon-comments@example.edu

Using Settings.yml

Notifications

This email address is used as the from address for emails sent from Avalon including batch ingest emails and collection creation and modification emails sent to administrators. It also receives emails for stalled and unowned batch ingests.

Using Environment Variables

Using Settings.yml

Support

This email address appears in certain error messages presented to the user when a system administrator is needed to resolve a problem.

Using Environment Variables

Using Settings.yml