Mario Fetka
5897512fd9
Complete the current IMAP, POP3, SMTP and proxy protocol work; add the validated setup and administration UI, packaging examples, tests, and maintained roadmap/documentation for the 0.7 development line.
46 lines
1.7 KiB
Groff
46 lines
1.7 KiB
Groff
.TH BONGO-SETUP 1 "July 2026" "Bongo 0.7.0" "Bongo setup"
|
|
.SH NAME
|
|
bongo-setup \- guided initial setup for a Bongo server
|
|
.SH SYNOPSIS
|
|
.B bongo-setup
|
|
.SH DESCRIPTION
|
|
.B bongo-setup
|
|
is a curses wizard for a new Bongo installation and must be run as root from
|
|
an interactive terminal. It asks deployment-level questions and retains safe
|
|
defaults for individual protocol limits.
|
|
.PP
|
|
The wizard configures the server hostname, IPv4 listener, hosted domains, Web
|
|
deployment behind Apache, nginx, Nginx Proxy Manager or a direct LAN listener,
|
|
an optional HAProxy mail frontend, IMAP, POP3, submission and ManageSieve,
|
|
the optional rate-limited internal relay, LDAP authentication and legacy TLS
|
|
compatibility.
|
|
.PP
|
|
Local ClamAV and SpamAssassin services are probed with their harmless
|
|
.B PING
|
|
commands. A Bongo scanner agent is enabled only after the service returns the
|
|
expected response. The wizard does not overwrite files owned by either
|
|
scanner package; loopback-only fragments are installed in the Bongo examples
|
|
directory.
|
|
.SH SECURITY
|
|
The administrator password and initial JSON configuration bundle are passed
|
|
to
|
|
.BR bongo-config (1)
|
|
through anonymous inherited file descriptors. Neither value is placed in the
|
|
process argument list and no named password file is created.
|
|
.PP
|
|
All generated documents are validated together before installation. Store
|
|
configuration document names contain JSON but have no
|
|
.B .json
|
|
suffix.
|
|
.SH FILES
|
|
.TP
|
|
.I /usr/share/bongo/examples/antispam
|
|
ClamAV and SpamAssassin configuration fragments.
|
|
.TP
|
|
.I /usr/share/bongo/examples/reverse-proxy
|
|
Apache, nginx, Nginx Proxy Manager and HAProxy examples.
|
|
.SH SEE ALSO
|
|
.BR bongo-config (1),
|
|
.BR bongo-admin (1),
|
|
.BR bongo-manager (1)
|