Files
bongo/man/bongoagents.8
2026-07-23 15:57:32 +02:00

63 lines
2.0 KiB
Plaintext

.TH BONGOAGENTS 8 "July 2026" "Bongo @BONGO_V_STR@" "Bongo services"
.SH NAME
bongoantispam, bongoavirus, bongocollector, bongoimap, bongopop3,
bongoqueue, bongorules, bongosieve, bongosmtp, bongosmtpc, bongostore,
bongodirector, bongoworker \-
Bongo server agents
.SH DESCRIPTION
Bongo is split into supervised agents. They are normally started by
.BR bongo-manager (1)
or the operating-system service unit and should not be launched manually.
.TP
.B bongostore
Owns per-user mail, calendar and contact storage and exposes the internal Store
protocol.
.TP
.B bongoqueue
Routes queued messages through filtering and delivery agents.
.TP
.B bongosmtp
Accepts SMTP, submission and internal-relay traffic according to the configured
listener policy. TLS and authentication policy are listener-specific.
.TP
.B bongosmtpc
Delivers outgoing SMTP and applies configured transport security policy.
.TP
.B bongoimap
Provides IMAP4rev2, IMAP4rev1 and legacy IMAP4 access, including TLS, SASL,
mailbox mutation and client identification.
.TP
.B bongopop3
Provides POP3 and POP3S access.
.TP
.B bongosieve
Provides ManageSieve access to the server-side Sieve engine.
.TP
.B bongorules
Executes server-side mail filtering rules and vacation actions.
.TP
.B bongocollector
Collects mail from user-configured external IMAP or POP3 accounts and submits
it to the selected Bongo mailbox.
.TP
.B bongoantispam
Integrates SpamAssassin-compatible spam scanning when enabled.
.TP
.B bongoavirus
Integrates ClamAV scanning when enabled.
.TP
.B bongodirector
Runs the internal event director used by legacy agent integrations.
.TP
.B bongoworker
Runs persistent scheduled jobs such as ACME renewal, scanner-health checks,
and TLS report delivery.
.SH SECURITY
Public agents should run as the unprivileged Bongo account after binding their
listeners. Configure clear-text legacy protocol support only on explicitly
trusted listeners. Authentication failures use structured log fields suitable
for the supplied Fail2ban rules.
.SH SEE ALSO
.BR bongo-admin (1),
.BR bongo-manager (1)