rpibmc/README.md

# RPiBMC
A BMC (LOM) created with a Raspberry Pi.

**STOP:** This project is deprecated; I stopped using it several years ago. If you're looking to do this today, [an RPi KVM](https://pikvm.org/) is a much more robust solution!

Allows one to build a Raspberry Pi-based BMC unit for an IPMI-less server. The
Raspbian system must include the package `screen` and (via `pip`) the Python
libraries `python-daemon` and `raspberry-gpio-python` (installed by default).

More information can be found here: https://www.boniface.me/post/a-raspberry-pi-bmc/ 

There are three main files:

1) `bmcd` - BMC Daemon

   Runs in the background of the system and handles reading and writing GPIO.
   
2) `bmc.sh` - The BMC shell

   Should be set as the default shell of the login user (`bmc`) and provides
   user interface to the BMC.
   
3) `rc.local` - The rc.local file

   The system `rc.local` should be replaced (or symlinked) to this file to start
   the `bmcd` daemon and `screen` console session on boot.