How to set up a mail server in Ubuntu or Debian

I had originally written this tutorial for

This tutorial will discuss how to set up a working mail server in Ubuntu or Debian. As we know, the two major protocols used in a mail server are SMTP and POP/IMAP. In this tutorial, postfix will be used for SMTP, whiledovecot will be used for POP/IMAP. Both are open source, stable and highly customizable.
Please note that securing a mail server is beyond the scope of this tutorial, and will be covered in future tutorials.


Each domain should have a DNS server. It is recommended NOT to use a live domain for testing purposes. In this tutorial, a test domain example.tst will be used in a lab environment. A DNS server for this hypothetical domain should have the following records at the least.
  • Forward zone for example.tst:
       IN MX 10 mail.example.tst.
    mail.example.tst. IN A
  • Reverse zone for example.tst:  IN PTR mail.example.tst.
    While configuring a live mail server, these records can be changed based on system requirements.

    Setting Hostname

    First, the hostname of the mail server must be specified in /etc/hostname and /etc/hosts. The former should contain the hostname only.
    root@mail:~# vim /etc/hostname
    root@mail:~# vim /etc/hosts
    ## IP   Fully Qualified Domain Name  Hostname ##  mail.example.tst   mail

    Adding Users

    Every Linux user, by default, has a mailbox automatically created. These users and mailboxes will be used as email accounts and their respective mailboxes. Creating a user is very easy.
    root@mail:~# adduser sarmed

    Install and Configure SMTP

    Service Profile: postfix
    Configuration file directory/etc/postfix/
    Log file/var/log/mail.log
    Port numberTCP/25

    SMTP: Installing postfix

    postfix is one of the most widely used SMTP servers because it is stable, lightweight, scalable, and highly customizable. Setting up postfix can be done using apt-get.
    root@mail:~# apt-get install postfix
    During installation, the type of email server and the domain name are specified.
    Since this mail server will send emails directly towards destination, "Internet Site" is used.
    The domain name of the mail server is also set. This will cause all mails originating from this mail server to have@example.tst as the sender's domain.
    The configuration files of postfix are stored in /etc/postfix. The following configuration files are important. Some of them may not be present and need to be created manually.
    • transport: Primarily used to define how a mail should be routed towards specific destination domains. Bypassing DNS queries can be a good example. In that case, one may need to send emails destined to domain directly to IP address X.Y.Y.X regardless of any DNS query results.
    • access: Can be used for security purposes like blocking senders/recipients and their domains.
    • aliases: Is used to define user aliases. For example, emails sent to userA should be received by userB and userC as well.
    • Is the configuration file for postfix.

    SMTP: Preparing Configuration Files

    Time to prepare the configuration files. The transport and aliases files are not provided with the installation, and created manually.
    root@mail:~# cd /etc/postfix
    root@mail:/etc/postfix# touch transport aliases
  • is backed up and then modified. The following lines are added/modified in the configuration file. For more detailed info about the parameters, refer to the official README and configuration document.
    root@mail:/etc/postfix# vim
    ## the name of the server ##
    myhostname = mail.example.tst
    ## alias definitions ##
    alias_maps = hash:/etc/postfix/aliases
    alias_database = hash:/etc/postfix/aliases
    ## transport definition ##
    transport_maps = hash:/etc/postfix/transport
    ## myorigin defines the domain name for emails originated from this server. In this case, all outgoing mail should have '@example.tst' as sender domain ##
    myorigin = example.tst
    ## mydestination parameter specifies what domains this machine will deliver locally, instead of forwarding to another machine. ##
    mydestination = mail.example.tst, localhost.example.tst, localhost, hash:/etc/postfix/transport
    ## the smarthost address. Not used in this tutorial and will be covered in the future##
    relayhost =
    ## the trusted sender networks. postfix will not forward mails originated from other subnets ##
    mynetworks = [::ffff:]/104 [::1]/128
    ## mailbox size in bytes. 0 denotes no limit ##
    mailbox_size_limit = 0
    ## postfix will listen on all available interfaces i.e. eth0, eth1, eth2 and so on ##
    inet_interfaces = all
  • transport
  • Mails destined to domain example.tst are defined to be delivered locally without any DNS queries.
    root@mail:/etc/postfix# vim transport
    example.tst local:
    .example.tst local:
    root@mail:/etc/postfix# postmap transport
  • aliases
  • Assuming all mails sent to userA should be received by userB as well, the aliases file is modified as stated below.
    root@mail:/etc/postfix# vim aliases
    userA: userA, userB
    root@mail:/etc/postfix# postalias aliases
    Note: The syntax 'userA: userB' specifies that the mail should be forwarded to userB only. userA will not receive a copy of the email.

    SMTP: Initiating the Service

    postfix can be started using the command.
    root@mail:~# service postfix restart
    The log file at /var/log/mail.log should provide useful information in case something fails. Whether or not the mail server is listening on TCP port 25 can also be verified using netstat.
    root@mail:~# netstat -nat
    tcp     0        0*    LISTEN
    As it can be seen from the output, the server is listening on TCP port 25 for incoming connection requests.

    Install and Configure POP/IMAP

    Service Profile: dovecot
    Configuration file directory/etc/dovecot
    Log file/var/log/mail.log
    Port numberTCP: 110 (POP3), 143 (IMAP), 993 (IMAPS), 995 (POP3S)

    POP/IMAP: Installing dovecot

    dovecot is without a doubt leading IMAP and POP server software used in the open source community. It is very easy to set up and configure dovecot. Once again, apt-get will be used to install dovecot.
    root@mail:~# apt-get install dovecot-common dovecot-pop3d dovecot-imapd
    Out of the box, dovecot can support POP3 and IMAP (plain text), as well as encrypted POP3S and IMAPS (secured). By default, dovecot will create and use a self-signed certificate for SSL encryption. Certificates can be manually created or imported later based on requirements. In this tutorial, a self-signed certificate generated bydovecot will be used.

    POP/IMAP: Preparing Configuration Files

    The following parameters are modified as needed.
    root@mail:~# vim /etc/dovecot/conf.d/10-mail.conf
    ## the location of the mailbox is specified in 'mbox' format ##
    mail_location = mbox:~/mail:INBOX=/var/mail/%u
    ## dovecot is granted necessary permission to read/write user mailboxes ##
    mail_privileged_group = mail
    That should be enough to start POP/IMAP service in the mail server.

    POP/IMAP: Initiating the Service

    Now that dovecot is installed and configured, it can be launched using the following command.
    root@mail:~# service dovecot restart
    Again, The log file (/var/log/mail.log) can provide important clues should something go wrong. Whetherdovecot is running can also be verified using netstat.
    root@mail:/etc/dovecot/conf.d# netstat -nat
    tcp      0      0      0*      LISTEN
    tcp      0      0      0*      LISTEN
    tcp      0      0      0*      LISTEN
    tcp      0      0      0*      LISTEN

    Using the Mail Server with Mail User Agent (MUA)

    The mail server is now ready to be used. Email accounts can be configured using your favorite email client software in desktop, laptop, tablet or phone. Webmail can also be configured in the server, but setting up webmail will be covered in future tutorials. The following is a screenshot with necessary parameters in Mozilla Thunderbird.

    Troubleshooting Mail Server

    • The log file /var/log/mail.log is your best friend. Any clue about why email is not working can be found here.
    • Make sure that the firewall is properly configured.
    • Make sure that the DNS server has proper entries.
    To sum up, the demonstration in this tutorial is meant to run in a lab environment. A test DNS server with all necessary records can be deployed, and mails can be exchanged between users in the same server, i.e., same domain. To make things more interesting, multiple mail servers with different domains can be deployed to check how email communication works across domains, given that necessary DNS records are present.
    Valid DNS records are needed for live mail servers. The settings of postfix and dovecot can be tuned based on needs.
    Warning: For those who want to deploy live mail servers, or any mail server that has access to the Internet, make sure that your SMTP is secured. Attacks on SMTP can commonly originate from the Internet, as well as from malicious software within the LAN.
    Hope this helps.