How to send an email through the Oracle Cloud Email Delivery service via Mailx in the Terminal
The Oracle Cloud Infrastructure provides an Email Delivery service that enables users to send bulk emails to their recipients. The official documentation to get started lies here.
This tutorial lays out the basic steps to accomplishing email sending using this service via Mailx referencing the official tutorial and the linked YouTube video by OraTube.
Cost
From that same website, we see the current cost of sending emails. The FAQ states one email is equivalent to 2 MB or one recipient in the To, CC, or BCC fields.
Screenshot of Oracle Cloud website that shows the current price of the email delivery at $0.00 for the first 3100 emails and $0.085 for every 1000 emails above that
Set up Email Delivery service on OCI
First, you need to set up the Email Delivery service on OCI.
1. Create an SMTP Credential. Click your profile picture and click Generate credentials in SMTP credentials. Make sure to save the user and password info:
2. Go to the Email Delivery service
3. Create an Approved Sender using an email in a server you control or a random email that may not even exist (I use fdurrani@ulhqlkypwzshkgqhwqfb.com which does not exist). This will be your From email.
Note that sending emails from unverified domains may lead to email bounces, quarantine, or restrictions of the recipient from receiving your email:
4. Navigate to the Configuration tab of Email Delivery and copy the information on the page:
Install Mailx
- Assuming you’re on Oracle Linux 8 (which you can create within an OCI Compute Instance), install Mailx in the Terminal using:
sudo yum install mailx -y
2. After installation, open the /etc/mail.rc
file and add the following information (ignore the ...
). Save the file
...
#smtp settings
set nns-config-dir=/etc/pki/nssdb
set smtp-use-starttls
set smtp-auth=plain
set smtp=smtp.email.us-ashburn-1.oci.oraclecloud.com
set from=fdurrani@ulhqlkypwzshkgqhwqfb.com
set smtp-auth-user=ocid1.user.oc1..aaaaaaaaaznjxw5fvpuizguxf5avbsje6sbta7j53oh3gyhiorp73fq@ocid1.tenancy.oc1..aaaaaaaaaeve7ubmplo4cxobeukpwp2uaiuusekfkut3hcvblaanpa.go.com
set smtp-auth-password=0jfpB;uQpAjh_u!a
Be sure to change the last four lines with your credentials. smtp can be retrieved from the Configuration page, and the user and password can be retrieved from the SMTP credentials you created earlier.
Send an email
Once you saved the mail.rc file, write this command in your Terminal, replacing your sender and recipient emails, smtp information, port, user, and password information appropriately.
echo "Test Monday morning Email" | mail -v -s "Send an email via mailx" -r "Faris<fdurrani@ulhqlkypwzshkgqhwqfb.com>" -S replyto="Faris><fdurrani@ulhqlkypwzshkgqhwqfb.com>" -S smtp="smtp.email.us-ashburn-1.oci.oraclecloud.com:25" -S smtp-use-starttls -S smtp-auth=plain -S smtp-auth-user='ocid1.user.oc1..aaaaaaaaaznjxw5fvpuizguxf5avbsje6sbta7j53oh3gyhiorp73fq@ocid1.tenancy.oc1..aaaaaaaaaeve7ubmplo4cxobeukpwp2uaiuusekfkut3hcvblaanpa.go.com' -S smtp-auth-password='0jfpB;uQpAjh_u!a' -S ssl-verify=ignore fdurrani@mythics.com
Click Enter. If authentication is successful, you will see this message in the Terminal:
Open your inbox and you will see your email (ignore the CAUTION line that was automatically added):
References
Safe harbor statement
The information provided on this channel/article/story is solely intended for informational purposes and cannot be used as a part of any contractual agreement. The content does not guarantee the delivery of any material, code, or functionality, and should not be the sole basis for making purchasing decisions. The postings on this site are my own and do not necessarily reflect the views or work of Oracle or Mythics, LLC.
This work is licensed under a Creative Commons Attribution 4.0 International License.