.nh
.TH bluechi 1
.SH NAME
bluechi-controller \- Controller of services across agents

.SH SYNOPSIS
\fBbluechi-controller\fP [\fIoptions\fP]

.SH DESCRIPTION
Eclipse BlueChi™ is a systemd service controller intended for multi-nodes environments with a predefined number of nodes and with a focus on highly regulated environment such as those requiring functional safety (for example in cars).

.PP
The bluechi controller offers its public API on the local DBus and uses the DBus APIs provided by all connected \fBbluechi-agents\fR to manage systemd services on those remote systems.

.PP
\fBbluechi-controller [OPTIONS]\fP

.SH OPTIONS
.SS \fB--help\fP, \fB-h\fP
Print usage statement and exit.

.SS \fB--port\fP, \fB-p\fP
The port on which bluechi-controller is listening for and setting up connections with \fBbluechi-agents\fR\&. This option will overwrite the port defined in the configuration file.

.SS \fB--config\fP, \fB-c\fP
Path to the configuration file, see \fBbluechi-controller.conf(5)\fR\&.

.SS \fB--version\fP,  \fB-v\fP
Print current bluechi version

.SH Environment Variables
\fBbluechi-controller\fR understands the following environment variables that can be used to override the settings from the configuration file (see \fBbluechi-controller.conf(5)\fR).

.SS \fBBC_LOG_LEVEL\fP
The level used for logging. Supported values are:
.IP \(bu 2
\fBDEBUG\fR
.IP \(bu 2
\fBINFO\fR
.IP \(bu 2
\fBWARN\fR
.IP \(bu 2
\fBERROR\fR

.SS \fBBC_LOG_TARGET\fP
The target where logs are written to. Supported values are:
.IP \(bu 2
\fBstderr\fR
.IP \(bu 2
\fBstderr-full\fR
.IP \(bu 2
\fBjournald\fR

.SS \fBBC_LOG_IS_QUIET\fP
If this flag is set to \fBtrue\fR, no logs are written by \fBbluechi\fR\&.

.SH Exit Codes
TBD

.SH CONFIGURATION FILES
\fBbluechi-controller.conf(5)
\[la]https://github.com/eclipse\-bluechi/bluechi/blob/main/doc/man/bluechi\-controller.conf.5.md\[ra]\fP