postmap Email / SMTP Origin: Network OSI layer 7 · Application Last updated 18 Nov 2026

Postfix: warning: database /etc/postfix/transport.db is older than source file (run postmap)

A hash/lookup table was edited but its compiled .db file wasn't rebuilt, so Postfix uses the old data.

Exact message you may see warning: database /etc/postfix/transport.db is older than source file /etc/postfix/transportdatabase is older than source file postmappostfix warning database older than sourcehash:/etc/postfix/virtual is older than source
Seen on: Postfix Linux

Meaning

Rebuild with postmap /etc/postfix/transport (or postalias for aliases) after every edit, then postfix reload. Automate in deployment scripts. The warning appears in /var/log/mail.log at each lookup until fixed.

Common causes

  • Edited map without running postmap
  • Deployment copied source only
  • File timestamp issues
  • Container image missing built maps
  • Permissions prevented writing .db

⚡ Quick fix

  1. sudo postmap /etc/postfix/transport
  2. sudo postfix reload
  3. Add postmap to the deployment step

Detailed fix by platform

Shell

  1. bash
    sudo postmap /etc/postfix/transport /etc/postfix/virtual /etc/postfix/sasl_passwd
    sudo postfix reload

How to diagnose

  1. .db — Newer than source?
  2. postmap — Run?
  3. Reload — Done?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Network. Errors that are often confused with or caused by this one (click to open):

aliases — Postfix/sendmail: fatal: open database /etc/aliases.db: No such file or directory (run newaliases) (Email / SMTP)aliasesloops back — Postfix: mail for example.com loops back to myself (status=bounced, local loop) (Email / SMTP)loops backlost connection — Postfix: lost connection after EHLO / SSL_accept error from client (TLS handshake problems) (Email / SMTP)lost connectionPostfix: bind 0.0.0.0 port 25: Address already in use — Postfix: fatal: bind 0.0.0.0 port 25: Address already in use (Email / SMTP)Postfix: bind 0.0.0.0…Postfix: Host or domain name not found — Postfix: status=deferred (Host or domain name not found. Name service error for name=example.com type=A: Host not found, try again) (Email / SMTP)Postfix: Host or doma…Postfix: SASL authentication failed — Postfix: warning: SASL authentication failure: cannot connect to saslauthd server: No such file or directory (Email / SMTP)Postfix: SASL authent…Postfix: status=deferred (connect ... Connection timed out) — Postfix: status=deferred (connect to gmail-smtp-in.l.google.com[142.250.27.26]:25: Connection timed out) (Email / SMTP)Postfix: status=defer…postmap

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.