How to use SMTP commands?

The Simple Mail Transfer Protocol (SMTP) is the standard protocol for sending emails across the internet. It handles routing, delivering and relaying emails between servers.

How to use SMTP commands?To manage mail servers and email delivery, system administrators and IT professionals use various SMTP commands. These allow you to control user access, configure mailing options, send test messages, monitor activity and more.

This comprehensive guide covers:

  • Basics of SMTP and how emails are sent
  • Common SMTP commands for mail servers
    • HELO
    • EHLO
    • RCPT TO
    • DATA
    • RSET
    • NOOP
    • QUIT
  • SMTP response codes
  • Configuring SMTP services
  • SMTP command options
  • Automation with SMTP
  • Troubleshooting tips

Follow along to learn the essential SMTP commands for sending, receiving and managing emails.

How SMTP Works

Before diving into using SMTP commands, it helps to understand basics of how SMTP handles email transmission:

  • SMTP is the protocol for sending mail
  • IMAP and POP3 are used by email clients to receive mail
  • Email clients don’t directly connect
  • Email submission flows through a series of SMTP servers:
    1. MUA – Mail User Agent (email client)
    2. MTA – Mail Transfer Agent (mail server)
    3. Relays MTAs – Servers that communicate
    4. Delivery MTA – Final server that hands email to recipient

So SMTP commands allow mail server admins to manage the sending, relaying and delivery of emails.

Common SMTP Commands

Here are the most common SMTP commands for interacting with mail servers:


The HELO command identifies the client to the SMTP email server.

It initiates the SMTP conversation, greeting the server.

Copy code


Note you should use the fully qualified domain name after the HELO command.


EHLO works the same way as HELO, identifying the client.

But EHLO also tells the server to use Extended SMTP. This allows usage of SMTP extensions and additional options.

Copy code



The MAIL FROM: SMTP command indicates who the email is from.

It sets the sender email address and initializes a new mail transaction:

Copy code

MAIL FROM: [email protected]


RCPT TO: specifies the email recipient.

Multiple recipients can be provided to send to several people:

Copy code

RCPT TO: [email protected]

RCPT TO: [email protected]


The DATA SMTP command begins the message content transmission.

It lets the server know message data is coming:

Copy code


After the DATA command, the email headers and body are sent. A . on a new line indicates the end of the message.


When something goes wrong mid-message, RSET can reset the SMTP connection.

This clears the queue and aborts the current mail transaction:

Copy code



Sometimes client-server connections can timeout if idle for too long. The NOOP or No Operation command prevents this by keeping the session active.

NOOP doesn’t actually do anything, but lets the server know the client is still connected.

Copy code



When finished transmitting messages, the connection can be closed with QUIT:

Copy code


This completes the SMTP conversation gracefully.

SMTP Response Codes

After each SMTP command is sent to a server, an SMTP response is returned indicating success, failure or other conditions.

Some common SMTP response codes:

  • 2xx – Success response
    • 250 OK
  • 4xx – Temporary error
    • 421 Server closing connection
    • Retry later
  • 5xx – Permanent error
    • 550 Mailbox unavailable
    • Sender issue

So for example, after identifying with EHLO, the server may return 250 Hello

And if the mailbox is not found after sending to it with RCPT TO, the response would be 550 Recipient not found.

Monitoring SMTP response codes allows diagnosis of email delivery issues.

Configuring an SMTP Server

The main steps to configure an SMTP email server are:

  1. Install – Choose SMTP server software like Postfix, Sendmail or Exchange Server
  2. Define domains – Specify domains to accept mail for
  3. Validate users – Have user verification protocol
  4. Configure connections – Set allowed clients, authentication, ports, etc.
  5. Test server – Send test messages to confirm operation
  6. Analyze activity – Review SMTP logs for errors or bottlenecks

Many settings can be controlled with SMTP command options:

Copy code


This EHLO option would enable enhanced status codes for more detailed errors.

Or starting TLS encryption:

Copy code


And authentication:

Copy code


<base64 encoded username>

<base64 encoded password>

Once up and running monitor closely at first for delivery issues or spam complaints. Fine tune as needed.

Automating with SMTP Commands

Because SMTP commands work in a standard client/server manner, they can be easily automated by scripts and programs.

For example making a simple Python script to:

  1. Open socket to SMTP server
  2. Perform handshake with EHLO
  3. Set sender with MAIL FROM
  4. Set recipient with RCPT TO
  5. Send message with DATA
  6. Close connection with QUIT

This allows creation of applications integrating custom email functionality through SMTP.

Troubleshooting Tips

If running into SMTP problems, some things to check:

Verify Connections

Confirm network connectivity and open ports between servers. Telnet port 25 manually to check.

Inspect SMTP Logs

Enable protocol level logging and review for errors after issues. Look for 4xx/5xx return codes.

Send Test Emails

Manually send test messages with Telnet or SMTP client libraries while debugging. Isolate components.

Check Spam Folders

Overly restrictive spam filters sometimes catch valid mail. Scan spam folders before reporting non-delivery.

Review Configs

Double check server and DNS records. Small things like typos can break mail functions.

And for advanced diagnostics, SMTP protocol analyzers provide deep inspection into server conversations. This aids tremendously in technical troubleshooting when other avenues fail.

Key Takeaways

The key takeaways for working with SMTP commands are:

  • SMTP handles email transmission between Mail Transfer Agents
  • HELO, EHLO, MAIL FROM, RCPT TO, DATA and other commands manage the sending and delivery
  • Response codes indicate success or failure conditions
  • Servers can be configured for security, optimization and policy enforcement
  • Automation is easy by scripting the text based commands
  • Log files and test messages help diagnose email issues

Following these SMTP best practices will assist configuration of performant and secure mail servers.


Using SMTP commands allows full control over email servers to efficiently transmit messages, enable security mechanisms and support automation.

Understanding the basics of how SMTP transports emails makes diagnosing connectivity and configuration issues much simpler.

From a protocol standpoint, not much has changed with SMTP since early RFCs in the 1980s. So knowledge gained today provides a solid foundation for managing email for the foreseeable future.

Now that you know the key SMTP protocol commands, you can optimize mail servers, analyze email delivery issues and script custom mailing solutions.

Frequently Asked Questions

  1. What are the basic SMTP commands?
    The basic SMTP commands are HELO/EHLO, MAIL FROM, RCPT TO, DATA, RSET, NOOP, and QUIT. These allow you to connect to a mail server, specify sender/recipients, transmit message content, reset connections, prevent timeouts and gracefully disconnect.

  2. How do I configure an SMTP server?
    To configure an SMTP server, choose and install server software, define permitted domains, implement user validation methods, set client access controls, open necessary network ports, and test with sample emails. Refine configurations as needed.

  3. What is the SMTP DATA command used for?
    The SMTP DATA command signals the start of the actual message content. After the DATA command, the client transmits message headers and the body terminated by a period on a new line. So it indicates you are sending the email itself next.

  4. Where can I view SMTP logs?
    Most SMTP servers have logging options to record activity. Server software like Postfix, Sendmail, and Exchange all enable logging to text files detailing errors, connections, rejections and more. Check configs for logging location. Common spots are /var/log/maillog or C:\Windows\System32\LogFiles\SMTPVC.

  5. Why am I not receiving emails sent to my SMTP server?
    If emails are not being received, common issues are firewall blocks, invalid recipients, spam filter exclusions or delivery errors like quota limits exceeded. Check SMTP response codes, server logs and test basic connectivity. Make sure recipients are legitimate addresses not being rejected up front.

  6. What is a 535 SMTP response code?
    The 535 SMTP status response indicates the authentication credentials provided were incorrect and access to perform the attempted action is denied. Double check the username and password if communicating securely.

  7. When would I use the SMTP NOOP command?
    The NOOP or No Operation command can be useful to periodically send during gaps between other commands to keep the session alive instead of timing out and disconnecting. Some servers close idle connections after a few minutes by design, so NOOP prevents this.

  8. Can I script SMTP commands to automate email sending?
    Yes, the text-based nature of SMTP makes it very easy to script and automate. Simple scripts can connect to servers, send required commands to setup mail transactions, transmit message data, then cleanly disconnect. Almost any language like Python, PERL, Bash, PowerShell, etc. can interface SMTP servers.

  9. How can I validate an SMTP server is working from the command line?
    Two options to test SMTP servers from the command line are connecting via Telnet on port 25 and communicating directly or using Linux/Unix utilities like mail or sendmail that integrate SMTP functionality for sending test mails.

  10. What tool can inspect low level SMTP traffic?
    Protocol analyzers like Wireshark allow deep inspection of the raw SMTP conversation between client and server. All commands and server responses can be analyzed to diagnose connectivity issues and delivery failures by viewing the SMTP traffic directly.

  11. Why is my mail server rejecting emails with a 554 response code?
    The 554 SMTP status code indicates the transaction failed for a permanent reason related to that specific message such as an invalid sender address. Check the rejected email for the cause like malformed headers that fail format checks or expired SSL/TLS certificates.

  12. How can I verify an SMTP server’s configuration?
    Tools like Telnet can manually interact with the SMTP server to confirm operation as expected based on configs. A more advanced option is using a service like which runs diagnostics against SMTP servers to validate many configuration aspects like DNS, ports, security, and deliverability.

  13. Why am I getting SMTP 421 connection errors?
    The 421 response code means the SMTP server actively closed or disconnected the TCP session with a client. This is usually a normal response when the client was idle for a longer period. Can also indicate a temporary local issue like overload. Trying reconnecting to verify if persistent.

  14. How can I configure Postfix SMTP relay hosts?
    Postfix’s has a relayhost directive to define an upstream SMTP server to relay mail through, specifying it by IP address or host name. Can configure as fallback relay or require relay by restricting local delivery with mynetworks setting.

  15. What are enhanced SMTP status codes?
    Enhanced status codes defined in RFC 1893 provide more details with 3 digit reply codes for easier diagnostics of issues compared to standard 2 digit codes. So instead of 550 mailbox unavailable for everything, enhanced codes differentiate things like 5.7.1 sender denied or 5.2.2 mailbox full.

  16. Where are Sendmail SMTP logs located?
    Sendmail uses two log files by default, typically located at /var/log/maillog for general activity and /var/log/mail.err or /var/log/ for recorded errors. May be configured differently but check those locations first when troubleshooting.

  17. How can I optimize SMTP server performance?
    Some ways to optimize SMTP servers are correctly sizing hardware, enabling DNS caching for reduced lookups, controlling connections with TCP wrappers, improving concurrency with multi-threading, scaling horizontally for load balancing, and inspecting logs closely to address bottlenecks.

Leave a Comment