Admin stuff

How to Install and Setup Sendmail on Ubuntu

Source: Cloudbooklet

How to install and configure Sendmail on Ubuntu for sending emails using a email server which routes or relays the mail delivery.

Sendmail is a opensource Mail Transfer Agent (MTA) which is used to route email using server or by using shell commands. You can also configure SMTP using Sendmail.

In this guide you are going to learn how to install and setup Sendmail on Ubuntu. Also you will setup SMTP and configure it with PHP.

Copy of which went offline. Retrieved from

Update Server Packages

SSH inside your server and update the packages to it’s latest version.

sudo apt update
sudo apt upgrade

Install Sendmail

Sendmail is available in the ubuntu repository, so you can directly install using apt install command.

sudo apt install sendmail

Configure Hostname

Edit the /etc/hosts file and add your hostname.

sudo nano /etc/hosts

On the line starting with, add the hostname to the end as it looks below. This should be on a single line. localhost hostname

Configure SMTP Authentication

Create new directory inside /etc/mail for SMTP configurations.

sudo mkdir /etc/mail/authinfo

Setup correct permissions.

sudo chmod -R 700 /etc/mail/authinfo

Create a new file for your SMTP authentication inside the newly created directory.

cd /etc/mail/authinfo
sudo nano smtp-auth

Paste the following line and replace the email-address with your login email and password with your password.

AuthInfo: "U:root" "I:email-address" "P:password"

Hit CRTL + X followed by Y and ENTER to save and exit the file.

Create a hash database map for the above created authentication.

sudo makemap hash smtp-auth < smtp-auth

Configure SMTP Connection

How to Install and Setup Sendmail on Ubuntu
How to Install and Setup Sendmail on Ubuntu
Image Cloudbooklet
Navigate to the sendmail configuration directory and edit the file.

cd /etc/mail
sudo nano

Add the below configurations right after the MAILER _DEFINITIONS line.

Replace smtp-host with your SMTP hostname.

define(`RELAY_MAILER_ARGS', `TCP $h 587')dnl
define(`ESMTP_MAILER_ARGS', `TCP $h 587')dnl
define(`confAUTH_OPTIONS', `A p')dnl
FEATURE(`authinfo',`hash -o /etc/mail/authinfo/smtp-auth.db')dnl

The configuration should look like the same as the screenshot.

Now save the file and exit the editor.

Rebuild Sendmail Configuration

Once the configuration is done you need to rebuild the Sendmail configuration using the make command.

cd /etc/mail

Once the configuration is rebuilt you need to restart Sendmail.

Restart Sendmail

Restart Sendmail using the following command.

sudo /etc/init.d/sendmail restart

Now you can send emails using SMTP.

Additional Configurations

Configuration with PHP

To use Sendmail with PHP you need to add sendmail path in your php.ini file.

sudo nano /etc/php/version/fpm-or-apache2/php.ini

To the bottom of the file add the following.

sendmail_path= /usr/sbin/sendmail -t -i

Restart Apache or PHP-FPM for the changes to take effect.

sudo service apache2 restart
sudo service php8.0-fpm restart

Sendmail SMTP Configuration without Auth

Incase if you have whitelisted your server IP for SMTP and you can send emails without authentication you can follow the below method.

You don’t need to create the smtp-auth file that we created above.

You can directly edit the file and make the following changes.

cd /etc/mail
sudo nano

Add the below configurations to the last.

Replace smtp-host with your SMTP hostname.

define(`RELAY_MAILER', `esmtp')dnl
define(`RELAY_MAILER_ARGS', `TCP $h 587')dnl

Save the file, rebuild configuration and restart Sendmail.

cd /etc/mail
sudo /etc/init.d/sendmail restart


Now you have learned how to install and configure Sendmail to relay using SMTP on Ubuntu.
Last edited: 30 April 2024 08:18:35