.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)