RAZOR-AGENT.CONF(1)

📦
version 2.88 · 16 versions
, in arch rolling

💅 RAZOR-AGENT.CONF(1) — the glow-up ✨

okay so this is razor-agent.conf(1), bestie — a User Contributed Perl Documentation page, no cap. it's the config file page and it's lowkey the most important one because it's where you tell the Razor agents how to behave. let's get into it 🫶

🎀 NAME 🎀

razor-agent.conf — the configuration file for Razor Agents. that's it, that's the name, she's iconic 💅

🌸 DESCRIPTION 🌸

razor-agent.conf is a configuration file that gets read by the razor agents, and the whole squad is here: razor-check(1), razor-admin(1), razor-report(1), and razor-revoke(1). literally all of them 🦋

the format is attribute = value pairs, one pair per line. that's it. keep it simple, keep it cute ✨

and if a line begins with #? that's a comment, babes. the agents will straight up ignore it. go off, annotate your config 💜

👑 ATTRIBUTES 👑

here's every attribute you can set, no skips, no cuts, we're covering all of them fr fr 🍓

  • razorhome — the directory where Razor Agents go looking for files. every file mentioned in razor-agent.conf that doesn't have a full path is gonna be relative to razorhome. the default is /etc/razor/ if you're root, and ~/.razor/ for every other user. and listen — if razorhome doesn't exist, it will be created. she makes herself at home 💅
  • logfile — the log file for the Razor Agents. default is razor-agent.log. that's where all the tea gets recorded 📝
  • debuglevel — controls how many messages get written to the logfile. it's an integer between 0 and 20. for example: a value of 1 logs only startup and error messages, 5 includes every transaction with the server, and 14 is extremely verbose information intended for debugging use only. so like, 14 is the "I need to see EVERYTHING" setting 👀
NOTE: 15 and higher create debug files on your filesystem — do not use unless you know what you are doing. like, seriously, that's a real warning, don't just crank it to 20 for funsies 😭
  • the default is 5. that's the vibe check passing level ✅
  • identity — specify an identity file to use for storing a newly registered identity during razor-admin(1). for razor-report(1) and razor-revoke(1), use this identity when authenticating with Razor Servers. if you don't specify one, <razorhome>/identity-<user> is used. she'll pick for you, don't worry 🫶
  • listfile_nomination — the file where Razor Nomination Servers are listed, in order of closest TCP ping time. Nomination Servers are used by razor-report(1) and razor-revoke(1). this file is created automatically. default is servers.nomination.lst ⭐
  • listfile_catalogue — the file where Razor Catalogue Servers are listed, in order of closest TCP ping time. Catalogue Servers are used by razor-check(1). this file is created automatically too. default is servers.catalogue.lst 🌈
  • listfile_discovery — the file where Razor Discovery Servers are listed, in random order. this one is created automatically using DNS. default is servers.discovery.lst 🧚
  • rediscovery_wait_dns — max time in seconds Razor Agents will wait before computing a new listfile_discovery using DNS. default is 604800, which is 7 days. a whole week of chilling 😌
  • rediscovery_wait — max time in seconds Razor Agents will wait before computing a new listfile_nomination and a new listfile_catalogue. default is 172800, which is 2 days. much more impatient than the DNS one, honestly 💀
  • turn_off_discovery — turns off closest host discovery. when set to 1, listfile_catalogue and listfile_nomination will not be updated and listfile_discovery is not read or updated. default is 0. so it's off by default, meaning discovery is ON by default. iykyk 🔥
  • ignorelist — automatically ignore mailing list posts. if set to 0, mailing list posts will be handled like all other mail. default is 0. so no special treatment unless you say so 🙈
  • whitelist — the name of the whitelist file. Razor Agents can consult a whitelist of addresses and SHA1 hashes before checking a mail with Razor Servers. if the address/hash is found on the whitelist, the mail is marked not spam, without checking against the server. the format of the whitelist can be found in the razor-whitelist(5) manpage. default is razor-whitelist 💖
  • min_cf — when checking spam, the server optionally returns a spam confidence value ranging from 0 (not confident) to 100 (absolutely or 100% confident). to be considered spam, the server's spam confidence value must be greater than or equal to min_cf. min_cf can be a number or an expression containing ac, the average confidence published by a Razor Server. examples: 0, 60, 100, ac, ac + 10, ac - 20. if an expression evaluates to less than 0 it becomes 0, likewise those greater than 100 become 100. the default is ac. math but make it cute 🧮✨
  • report_headers — when reporting spam, the entire email (headers and body) is sent to a Razor Nomination Server. when set to 0, all the headers are removed except headers beginning with Content- before sending, and a special header beginning with X-Razor2 is added to note this action. default is 1. so by default the whole email goes out — that's a big deal, know what you're signing up for 👀

💜 AUTHORS 💜

Vipul Ved Prakash, mail@vipul.net and Chad Norwood chad@samo.org. absolute icons, we stan 👑

🦋 SEE ALSO 🦋

go read them, bestie, they're all part of the same friend group 💅

okay that's the whole page!! and before you go — this glorious document came to you from perl v5.44.0, dated 2026-10-17, filed under RAZOR-AGENT.CONF(1) in the User Contributed Perl Documentation section. mwah 💋 slay, go configure your agents 🎀✨

📦 where this page comes from