lego-monitoring/archive-arch/README.md

lego-monitoring

DISCLAIMER: This repository does not have anything to do with the LEGO Group. "lego" is the internal name of my home server.

Prerequisites

• pacman -S libolm arch-audit
• pip -r requirements.txt

Configuring

• Invite the bot account to the room (you have to accept the invite manually)
• Copy config.example.json to config.json, edit as necessary
• Run alerting/login.py once to login into Matrix
• (optional) Create an alerting group and give config.json's ownership and read rights to it, to allow sending alerts from less-privileged users

Setting up login alerts

• Copy lego-login-alert to your /etc/sudoers.d
• Add this to your /etc/ssh/sshd_config:

# login alerts
ForceCommand /opt/lego-monitoring/wrappers/login_wrapper.sh

Running

• prettyprint.py -- check and print all sensors
• service.py -- launch service
• assets/lego-monitoring.service is a systemd unit that starts service.py

Disabling checks

Put names of checks into config's disabled_checks to disable them. See service.py for check names.