NOTIFYD(8)

πŸ’– NOTIFYD β€” the Cyrus notification server, bestie πŸ’–

okay so this is notifyd(8), from the Cyrus IMAP manual. she's the notification girlie. let's get into it ✨


🌸 NAME 🌸

notifyd β€” Cyrus IMAP documentation, and also: the Cyrus notification server. that's her. that's the whole vibe. πŸ’…


✨ SYNOPSIS ✨

notifyd [ -C config-file ]  [ -U uses ] [ -T timeout ] [ -D ]

literally just her name and her little flags, no notes πŸŽ€


πŸ¦‹ DESCRIPTION πŸ¦‹

so notifyd is a daemon β€” a background girlie β€” and she gets started from master(8). her whole job? handling notification requests on behalf of lmtpd(8). that's it, that's the role. she accepts the request and then performs the notification using the method specified in the request. main character energy, honestly. πŸ‘‘

🫢 heads up bestie: for notifyd to run properly you must set proto=udp in its cyrus.conf(5) services entry. prefork=1 is also recommended. do not skip this. fr fr.

notifyd reads her configuration options out of the imapd.conf(5) file, unless you say otherwise with -C. πŸ’–

and the notifysocket option is what specifies the Unix domain socket she listens on for notifications. that's the hangout spot. 🌈


πŸ’… OPTIONS πŸ’…

  • -C config-file β€” use the config file config-file you specified instead of the default imapd.conf(5). you're the one choosing, iconic.
  • -U uses β€” the maximum number of times the process should be used for new connections before shutting down. the default is 250. she has a limit and she respects it 😌
  • -T timeout β€” the number of seconds the process will wait for a new connection before shutting down. note that a value of 0 (zero) will disable the timeout. the default is 60.
  • -D β€” run the external debugger specified in debug_command. debugging era πŸ›

πŸŽ€ NOTIFICATION METHODS πŸŽ€

these are the ways she can pop off:

  • null β€” ignore the notification request. not me ignoring it πŸ™ˆ
  • log β€” log the notification to syslog (for testing). just journaling, for the plot.
  • mailto β€” email the notification. this method can ONLY be used in a Sieve 'notify' action, because it requires a mailto: URL to be specified as an :option. no exceptions bestie πŸ’Œ
  • zephyr β€” send the notification as a zephyrgram. if used in a Sieve 'notify' action, additional recipients can be specified as :options. zephyrgram is such a word. obsessed. πŸ¦‹
  • external β€” send the notification via an external program. the path to the program is specified using the notify_external option in the configuration file. outsourcing the task, we love a delegation queen πŸ‘‘

πŸ“ FILES πŸ“

  • /etc/imapd.conf
  • /etc/cyrus.conf

those are her spots. 🏠


πŸ”₯ SEE ALSO πŸ”₯

go read those too, iykyk πŸ’œ


πŸ‘‘ AUTHOR πŸ‘‘

The Cyrus Team, Nic Bernstein (Onlight). shoutout to the icons who built her 🫢


1993–2026, The Cyrus Team


okay that's the whole page bestie, you ate that. this was notifyd from Cyrus IMAP, version 3.12.4, dated Sep 09, 2026. periodt. πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from