.TH BONGO-MANAGER 1 "July 2026" "Bongo 0.7.0" "Bongo services"
.SH NAME
bongo-manager \- start and supervise Bongo agents
.SH SYNOPSIS
.B bongo-manager
.RI [ \-d ]
.RI [ \-f ]
.RI [ \-k ]
.br
.B bongo-manager
.BR \-s | \-r
.SH DESCRIPTION
.B bongo-manager
starts the Store, reads the agent list from the Store manager configuration,
and starts enabled agents in priority order.  It must be run as root so agents
can bind privileged ports; agents subsequently drop privileges.
.SH OPTIONS
.TP
.B \-d
Detach after starting agents.
.TP
.B \-k
Restart agents after a crash, subject to the crash-loop limit.
.TP
.B \-f
Force startup and replace the manager pid file.  Use only after verifying that
no manager is running.
.TP
.B \-s
Ask the running manager to stop.  This option cannot be combined with other
options.
.TP
.B \-r
Ask the running manager to validate and synchronize local configuration into
the Store, reload its manager configuration, and start agents which are not
running.  This option cannot be combined with other options.
.TP
.B \-h
Show help.
.SH FILES
.TP
.I /var/lib/bongo/work/bongomanager.pid
Manager pid file with the default state directory.
.SH SEE ALSO
.BR bongo-admin (1),
.BR bongoagents (8),
.BR systemctl (1)