bluechictl - Man Page

Simple command line tool to interact with the public D-Bus API of bluechi


bluechictl [options] command


A simple command line tool that uses the public D-Bus API provided by bluechi to manage services on all connected bluechi-agents and retrieve information from them.

bluechictl [Options]


--help, -h

Print usage statement and exit.

--version, -v

Print current bluechictl version


bluechictl [start|stop|freeze|thaw|restart|reload] [agent] [unit]

Performs one of the listed lifecycle operations on the given systemd unit for the bluechi-agent.

bluechictl [enable] [agent] [unit1,...]

Enable the list of systemd unit files for the bluechi-agent.


--force, -f
   Override existing symlinks

   Enable unit files temporarily until next reboot

   Don't reload daemon after enabling unit files

bluechictl [disable] [agent] [unit1,...]

Disable the list of systemd unit files for the bluechi-agent.


   Don't reload daemon after disabling unit files

bluechictl list-units [agent]

Fetches information about all systemd units on the bluechi-agents. If [bluechi-agent] is not specified, all agents are queried.


   Use glob filter for the unit names

bluechictl monitor [agent] [unit1,unit2,...]

Creates a monitor on the given agent to observe changes in the specified units. Wildcards * to match all agents and/or units are also supported.


bluechictl monitor

bluechictl monitor node1

bluechictl monitor \* dbus.service,apache2.service

bluechictl daemon-reload [agent]

Performs daemon-reload for the bluechi-agent.

bluechictl status [agent]

Fetches the status of all the agents or a specific agent: state (online/offline) and when was it last seen


--watch, -w
   Continuously display agent(s) status, updating when state change update received


bluechictl status

bluechictl status rpi

bluechictl status -w

bluechictl status [agent] [unit1,...]

Fetches the status of the systemd units for the bluechi-agent.