Send Email From the Command Line: 5 Tools

Yes, you can send email directly from the command line using tools like mail, sendmail, mutt, ssmtp, or curl. These utilities let you send a message with a single terminal command, useful for scripts, alerts, and automated reports.

Why Send Email From the Terminal?

Command-line email is a practical skill for anyone who manages servers or writes automation scripts. When a backup fails, a cron job finishes, or a disk fills up, you want a notification without opening a full email client. Sending email from the terminal makes that possible in one line, and it can be embedded in any script that runs on a schedule.

It is also a lightweight alternative to GUI email clients. You can send a quick message without launching a heavy application, and it works over SSH sessions where no graphical interface exists. Many system administrators rely on it daily for monitoring and reporting.

How Command-Line Email Works

Most command-line mail tools rely on a Mail Transfer Agent (MTA) or a Simple Mail Transfer Protocol (SMTP) server to deliver messages. The MTA handles the actual sending, while the command-line tool formats the message and hands it over.

There are two common approaches:

• Local MTA: Tools like sendmail or postfix run on your machine and deliver email directly to the recipient’s server. This requires a properly configured mail server and often a valid domain.
• External SMTP relay: Tools like ssmtp or curl connect to an SMTP server (e.g., Gmail, Outlook, or a transactional email service) that you have credentials for. This is easier for personal use and avoids running a full mail server.

When you run a command like echo "Hello" | mail -s "Subject" user@example.com, the tool constructs a message with headers (To, From, Subject) and a body, then passes it to the MTA or SMTP server. The server handles the rest, including retries if the recipient’s server is temporarily unavailable.

Choosing the Right Tool

Your choice depends on your environment and needs. Here is a quick comparison:

• mail / mailx: Preinstalled on many Unix-like systems. Simple to use, but configuration can be tricky for external SMTP. Best for local delivery or when a local MTA is already set up.
• sendmail: The classic MTA. It is powerful but complex to configure. Often used as a backend for other tools.
• mutt: A full-featured mail client that works in the terminal. Supports both sending and reading email, with attachments and multiple accounts. Overkill if you only need to send.
• ssmtp: A minimal MTA that forwards mail to an external SMTP server. Very easy to configure for Gmail or similar. Perfect for simple sending from scripts.
• curl: Not a mail tool per se, but it can send email via SMTP using the --url and --mail-from options. Useful if you already use curl and want to avoid installing extra packages.

Setting Up a Basic Sending Environment

For a quick start on a Linux system, you can use ssmtp with a free Gmail account. First install it:

sudo apt install ssmtp

Then edit /etc/ssmtp/ssmtp.conf to point to Gmail’s SMTP server:

root=your@gmail.com
mailhub=smtp.gmail.com:587
AuthUser=your@gmail.com
AuthPass=your-app-password
UseSTARTTLS=YES

Note that you need an app-specific password if you have two-factor authentication enabled. After configuration, you can send a test email:

echo "Test body" | ssmtp recipient@example.com

To include a subject, use the -s flag if your version supports it, or write the headers manually:

printf "Subject: Test\n\nBody" | ssmtp recipient@example.com

Common Problems and Fixes

Several issues can arise when sending email from the command line:

• Authentication errors: If you get “535 Authentication failed,” check your username and password. For Gmail, you must use an app password, not your regular password.
• Port blocked: Some networks block port 25 (SMTP). Use port 587 with STARTTLS or port 465 with SSL instead.
• Emails going to spam: Messages sent from a script often lack proper DKIM/SPF records. Use a reputable SMTP relay to improve deliverability.
• Cannot find mail command: On some minimal systems, mail is not installed. Install mailutils (Debian/Ubuntu) or mailx (RHEL/CentOS).
• Local MTA not running: If you use sendmail and it is not running, you will get a “Connection refused” error. Start the service or switch to an external relay.

Security and Best Practices

When sending email from scripts, security matters. Never hardcode passwords in scripts; use environment variables or a config file with restricted permissions. For example, in a shell script:

export SMTP_PASS='your-secret'
echo "Body" | ssmtp -S smtp.gmail.com:587 -auuser -ap"$SMTP_PASS" recipient@example.com

Also, be mindful of email headers. Always set a valid From address, and consider adding a Reply-To if you want responses to go elsewhere. For automated alerts, include a clear subject and a timestamp in the body so you can quickly identify the issue.

If you are sending sensitive data, use an encrypted connection (TLS) and avoid logging SMTP credentials. Many tools will log errors only, but check your system logs for any accidental password exposure.

Alternatives to Command-Line Email

If the command line seems too limited, there are alternatives:

• Scripting languages: Python’s smtplib, Ruby’s Net::SMTP, or PHP’s mail() function offer more control and error handling.
• Webhooks and messaging: Services like Slack or Discord can receive HTTP requests, which might be easier for team notifications.
• Monitoring tools: Nagios, Zabbix, or Grafana can send email alerts with built-in notification channels.

However, command-line email remains a simple, universal method that works on any Unix-like system without extra dependencies.

Frequently Asked Questions

How do I send an email with an attachment from the command line?

Use mutt with the -a flag: echo "Body" | mutt -s "Subject" -a /path/to/file -- recipient@example.com. For mailx, you can use -a as well, but it may require a MIME-capable version. Alternatively, use curl with SMTP and manually construct a MIME message.

Can I send email from Windows command prompt?

Yes, but it is less common. You can use PowerShell with Send-MailMessage (deprecated in newer versions) or use curl in Windows 10 and later. For example: curl --url "smtps://smtp.gmail.com:465" --ssl-reqd --mail-from "you@gmail.com" --mail-rcpt "recipient@example.com" --upload-file - --user "you@gmail.com:password" with the message in a file.

Why does my email go to spam when sent from the command line?

Email sent from a script often lacks proper authentication (SPF, DKIM) and may come from an IP with a poor reputation. Using a well-known SMTP relay like Gmail or a transactional service improves deliverability. Also, avoid spammy content like excessive links or all-caps subjects.

Is it safe to use Gmail SMTP for command-line email?

Yes, if you use an app password and enable TLS. Gmail’s SMTP is reliable and free, but it has sending limits (500 emails per day for free accounts). For higher volumes, consider a dedicated email service.

How do I test if my command-line email setup works?

Send a test message to yourself or a secondary address. Check the exit code of the command (0 means success). Also, monitor the mail queue with mailq if you use a local MTA. If the message bounces, you will receive a failure notice.

Related

• Secure Nginx for WordPress and phpMyAdmin
• GTA 5 Source Code Leak: What Happened & What It Means
• IAM Permissions for AI Agents in the Cloud