Mario Fetka
95 lines
2.5 KiB
Groff
95 lines
2.5 KiB
Groff
.TH BONGO-CONFIG 1 "July 2026" "Bongo 0.7.0" "Bongo configuration"
|
|
.SH NAME
|
|
bongo-config \- initialize and maintain a Bongo installation
|
|
.SH SYNOPSIS
|
|
.B bongo-config
|
|
.RI [ options ]
|
|
.I command
|
|
.RI [ arguments ]
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-h , " " \-\-help
|
|
Show command help.
|
|
.TP
|
|
.BR \-v , " " \-\-verbose
|
|
Enable verbose output.
|
|
.TP
|
|
.BR \-s , " " \-\-silent
|
|
Run initial installation non-interactively. This requires
|
|
.BR \-\-ip ,
|
|
.BR \-\-hostname ,
|
|
at least one
|
|
.BR \-\-domain
|
|
and
|
|
.BR \-\-admin-password-file
|
|
or an inherited password descriptor.
|
|
.TP
|
|
.BI \-\-ip= ADDRESS
|
|
Set the address used during initial setup.
|
|
.TP
|
|
.BI \-\-hostname= NAME
|
|
Set the primary DNS hostname.
|
|
.TP
|
|
.BI \-\-domain= DOMAIN
|
|
Add a hosted mail domain. May be specified more than once.
|
|
.TP
|
|
.BI \-\-admin-password-file= FILE
|
|
Read the initial administrator password from
|
|
.IR FILE .
|
|
Protect the file from other users and remove it after setup.
|
|
.TP
|
|
.BI \-\-admin-password-fd= FD
|
|
Read the initial administrator password from an inherited descriptor. This is
|
|
used by
|
|
.BR bongo-setup (1)
|
|
so the secret is not exposed as an argument or named file.
|
|
.TP
|
|
.BI \-\-config-bundle-fd= FD
|
|
Read the validated initial Store configuration bundle from an inherited
|
|
descriptor. Only known suffixless configuration document names are accepted,
|
|
and every value must be a JSON object.
|
|
.SH COMMANDS
|
|
.TP
|
|
.B install
|
|
Initialize state, Store configuration, the administrator account and initial
|
|
TLS material.
|
|
.TP
|
|
.B crypto
|
|
Create missing local TLS material or validate and retain an existing complete
|
|
certificate/key pair. Unsafe or incomplete material is rejected. ACME
|
|
deployments normally install certificates through their deploy hook instead.
|
|
.TP
|
|
.B checkversion
|
|
Show build-version information and query the configured update source.
|
|
.TP
|
|
.B tzcache
|
|
Rebuild Bongo's runtime timezone cache from the installed zone snapshot. This
|
|
does not download or update IANA timezone source data.
|
|
.TP
|
|
.B wizard
|
|
Execute the guided
|
|
.BR bongo-setup (1)
|
|
interface.
|
|
.TP
|
|
.BI "user add " USER
|
|
Add a local user.
|
|
.TP
|
|
.B user list
|
|
List local users.
|
|
.TP
|
|
.BI "user password " USER
|
|
Read and set a user's password interactively.
|
|
.SH ZONEINFO MAINTENANCE
|
|
Source-tree maintainers can refresh the checked-in timezone snapshot with the
|
|
explicit CMake target
|
|
.BR update-zoneinfo .
|
|
Configure
|
|
.B BONGO_TZDATA_DIR
|
|
to an unpacked IANA tzdata directory first. The target is never part of the
|
|
normal build or install and rewrites files in the source tree only when called
|
|
explicitly.
|
|
.SH SEE ALSO
|
|
.BR bongo-admin (1),
|
|
.BR bongo-setup (1),
|
|
.BR bongo-manager (1)
|