Featured resource
Forrester Wave Report 2025
Pluralsight named a Leader in the Forrester Wave™

Our tech skill development platform earned the highest scores possible across 11 criteria.

Learn more
  • Labs icon Lab
  • Cloud
Google Cloud Platform icon
Labs

Troubleshooting a Postfix Installation

Understanding a service well enough to troubleshoot it is an important skill as a System Administrator. In this lab, we'll go over troubleshooting a Postfix installation.

Google Cloud Platform icon
Labs

Path Info

Level
Clock icon Intermediate
Duration
Clock icon 15m
Published
Clock icon Aug 21, 2020

Contact sales

By filling out this form and clicking submit, you acknowledge our privacy policy.

Table of Contents

  1. Challenge

    Fix the relay error given during testing

    First, we verify the reported issue by conducting our own test.

    telnet localhost smtp
    Trying ::1...
    Connected to localhost.
    Escape character is '^]'.
    220 server1.example.com ESMTP Postfix
    
    ehlo localhost
    250-server1.example.com
    250-PIPELINING
    250-SIZE 10240000
    250-VRFY
    250-ETRN
    250-ENHANCEDSTATUSCODES
    250-8BITMIME
    250 DSN
    
    mail from: [email protected]
    250 2.1.0 Ok
    
    rcpt to: [email protected]
    454 4.7.1 <[email protected]>: Relay access denied
    
    quit
    221 2.0.0 Bye
    

    Relay access denied means there's something wrong with the postfix configuration. If we look at /etc/postfix/main.cf, we find that the mydestination setting has this:

    mydestination = $myhostname, localhost.$mydomain, localhost
    

    It's missing the $mydomain setting at the end of the line. So changing it to:

    mydestination = $myhostname, localhost.$mydomain, localhost, $mydomain
    

    Then restart postfix to resolve the error.

    telnet localhost smtp
    
    Trying ::1...
    Connected to localhost.
    Escape character is '^]'.
    220 server1.example.com ESMTP Postfix
    
    ehlo localhost
    250-server1.example.com
    250-PIPELINING
    250-SIZE 10240000
    250-VRFY
    250-ETRN
    250-ENHANCEDSTATUSCODES
    250-8BITMIME
    250 DSN
    
    mail from: [email protected]
    250 2.1.0 Ok
    
    rcpt to: [email protected]
    250 2.1.5 Ok
    
    data
    354 End data with <CR><LF>.<CR><LF>
    
    test.
    .
    250 2.0.0 Ok: queued as 9B26C97CBF
    
    quit
    221 2.0.0 Bye
    Connection closed by foreign host.
    
  2. Challenge

    Set cloud_user up to receive all of root's email

    The easiest way in my experience is to first verify the alias_maps setting in postfix's main.cf.

    grep alias_maps /etc/postfix/main.cf
    ...
    alias_maps = hash:/etc/aliases
    ...
    

    After making sure that's set to hash:/etc/aliases, we can edit /etc/aliases and make sure there's a root: cloud_user line at the end, and then run the newaliases command.

Pluralsight Skills gives leaders confidence they have the skills needed to execute technology strategy. Technology teams can benchmark expertise across roles, speed up release cycles and build reliable, secure products. By leveraging our expert content, skill assessments and one-of-a-kind analytics, keep up with the pace of change, put the right people on the right projects and boost productivity. It's the most effective path to developing tech skills at scale.

What's a lab?

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Provided environment for hands-on practice

We will provide the credentials and environment necessary for you to practice right within your browser.

Guided walkthrough

Follow along with the author’s guided walkthrough and build something new in your provided environment!

Did you know?

On average, you retain 75% more of your learning if you get time for practice.