UPGRADING(3pm)

✨ UPGRADING ✨ (that's the 3pm perl-manual-page one, bestie 💖)

okay so this is the qpsmtpd upgrade notes page — literally your lil' survival guide for when you're hopping from an old version to a newer one 🦋

---

💅 NAME 💅

qpsmtpd — Upgrade notes 📝

---

🌸 Upgrade notes 🌸

When you're upgrading, bestie, please actually read these notes for whichever version(s) you're upgrading from. Like, don't skip them, they're there for a reason 🙈

🎀 v0.84 or below 🎀

CHECK_RELAY, CHECK_NORELAY, RELAY_ONLY

so all 3 of these plugins are deprecated 💀 and they've been replaced by a shiny new plugin called relay. the new one reads the same config files as the old ones did (peep perldoc plugins/relay for the deets).

and if you want the equivalent functionality of enabling relay_only, just use the only argument on the relay plugin — it's all documented in the RELAY ONLY section of plugins/relay. iykyk 🫶

GREYLISTING plugin

the mode config argument? yeah, deprecated. use reject and reject_type instead, periodt ✨

also the greylisting DB format changed to accommodate IPv6 addresses. why? because the DB key has colon : separated fields, and IPv6 addresses are colon delimited — collision city 😭. so the new format converts the IPs into integers instead.

there's a new config option named upgrade that, when enabled, updates all the records in your DB to the new format. here's the whole ritual, no skips:

1. add upgrade 1 to the plugin entry in config/plugins
2. start up qpsmtpd once
3. make one connection
4. a log entry will be made, telling you how many records were upgraded 👑

then remove the upgrade option from your config. like, do it. don't leave it in there 🙈

SPF plugin

the spf_deny setting is deprecated. use the reject N setting instead — it gives admins way more granular control over SPF, which is iconic honestly.

for backward compatibility though: a spf_deny setting of 1 is mapped to reject 3, and a spf_deny 2 is mapped to reject 4. slay 🌈

P0F plugin

defaults to p0f v3 now (it was v2 before, if you're wondering why everything smells different 👀).

so you've got two options, bestie:

• upgrade p0f to version 3 🔥
• or add version 2 to your p0f line in config/plugins

perldoc plugins/ident/p0f for more details if you need the full lore 📖

---

and that's the page!! 💖 brought to you by perl v5.40.1, dated 2025-03-21 — from the UPGRADING(3pm) of the User Contributed Perl Documentation. go forth and upgrade responsibly, queen 👑✨🦋