Email addresses
These are the various email addresses which can be set. The most important one is the address that the registration emails are sent from.
EDXAPP_CONTACT_EMAIL
EDXAPP_DEFAULT_FEEDBACK_EMAIL
EDXAPP_DEFAULT_FROM_EMAIL
EDXAPP_BUGS_EMAIL
EDXAPP_BULK_EMAIL_DEFAULT_FROM_EMAIL
EDXAPP_PAYMENT_SUPPORT_EMAIL
EDXAPP_PRESS_EMAIL
EDXAPP_SERVER_EMAIL
EDXAPP_TECH_SUPPORT_EMAIL
EDXAPP_FEEDBACK_SUBMISSION_EMAIL
EDXAPP_UNIVERSITY_EMAIL
Bulk email
To enable bulk email, you must toggle the feature flag ENABLE_INSTRUCTOR_EMAIL
DEFAULT_BULK_FROM_EMAIL specifies the from address for email.
EMAIL_HOST, EMAIL_PORT, EMAIL_HOST_USER, EMAIL_HOST_PASSWORD, and EMAIL_USE_TLS
More information on this wiki page:
https://github.com/edx/edx-platform/wiki/Bulk-Email
to allow all courses to send bulk email, set settings.FEATURES[‘REQUIRE_COURSE_EMAIL_AUTH’] = False
otherwise, you need to give each course permission individually through:
https://SITE_NAME/admin/bulk_email/courseauthorization/add/
In addition, you also need to create a blank bulk email template by following the instructions here:
https://ondemand.cloudera.com/admin/bulk_email/courseemailtemplate/add/
NOTE: do not enter anything in the “name” field otherwise the bulk email page won’t be able to find the correct template. It’s a real mess.
Email templates
These are the five scenarios where emails are automatically sent to a student:
- student registering on Open edX site
- password reset
- instructor enrolling student not registered on Open edX site
- instructor enrolling student registered on Open edX site
- instructor unenrolling student from a course
Phrases and words like: “edX Demonstration Course,” “localhost:8000,” “Your Platform Name Here,” etc. will be replaced by appropriate values on the production server.
See all the email templates in Appendix A.
Enabling Amazon SES
Create IAM role/name for account
https://console.aws.amazon.com/ses/home?region=us-east-1#smtp-settings
“Create My SMTP Credentials”
Verify an email address
https://console.aws.amazon.com/ses/home?region=us-east-1#verified-senders-email
or a domain
https://console.aws.amazon.com/ses/home?region=us-east-1#verified-senders-domain
where the SES email will come from. This involves setting a DNS TXT record specified by Amazon
Setup DKIM verification for an individual email address
https://console.aws.amazon.com/ses/home?region=us-east-1#verified-sender-details:email:<email_address@example.com>
or a domain:
https://console.aws.amazon.com/ses/home?region=us-east-1#verified-sender-details:domain:<domain_name>
This involves setting three CNAME records, specified by Amazon.
After verification, the DKIM settings have to manually be enabled. Just a link at the above two URLs.
Send support ticket for “Production access”
Set the following vars in server-vars.yml
EDXAPP_AWS_ACCESS_KEY_ID:
EDXAPP_AWS_SECRET_ACCESS_KEY:
EDXAPP_EMAIL_BACKEND: “django_ses.SESBackend”
EDXAPP_EMAIL_HOST: “email-smtp…”#specified in SES console
EDXAPP_EMAIL_PORT: 25
EDXAPP_EMAIL_HOST_USER: #IAM role username
EDXAPP_EMAIL_HOST_PASSWORD: #IAM role password
EDXAPP_EMAIL_USE_TLS: true