icingabot/README.md

1001 B

Icinga Bot

Simple IRC Bot statusing icinga2 via its API.

Table of content

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+.