icingabot/README.md

Icinga Bot

Simple IRC Bot statusing icinga2 via its API.

Table of content

• Installation
• Licence

Installation

Requirements

On a Debian-based host - running at least Debian Stretch, you will need the following packages:

• git (recommended for getting the source)
• python3
• python3-irc
• python3-requests

Manual installation

1. Clone repo in /srv/

   $ cd /srv && git clone https://forge.april.org/adminsys/icingabot
   $ chmod a+x icingabot/icingabot.py
   

2. Install the configuration in etc

   $ mkdir /etc/icingabot
   $ cp icingabot/icingabot.conf /etc/icingabot/
   

3. Configure the application

   $ $EDITOR /etc/icingabot/icingabot.conf
   

4. Try it

   $ ./icingabot/icingabot.py
   

5. Install a launcher

   $ cp icingabot/icingabot.service /etc/systemd/system/
   

6. Start it

   $ systemctl start icingabot
   

License

Icinga Bot is developed by April and licensed under the AGPLv3+.