Beehive

Beehive is an event and agent system, which allows you to create your own agents that perform automated tasks triggered by events and filters. It is modular, flexible and really easy to extend for anyone. It has modules (we call them Hives), so it can interface with, talk to, or retrieve information from Twitter, Tumblr, Email, IRC, Jabber, RSS, Jenkins, Hue - to name just a few. Check out the full list of available Hives in our Wiki.

Connecting those modules with each other lets you create immensly useful agents.

Note

For this guide you should be familiar with the basic concepts of

License

Beehive is released under the AGPL-3.0 License.

Installation

Install Beehive:

[isabell@stardust ~]$ mkdir beehive
[isabell@stardust ~]$ cd beehive
[isabell@stardust beehive]$ wget https://github.com/muesli/beehive/releases/download/v0.4.0/beehive_0.4.0_Linux_x86_64.tar.gz
[isabell@stardust beehive]$ tar -xzvf beehive_0.4.0_Linux_x86_64.tar.gz
[isabell@stardust beehive]$ rm beehive_0.4.0_Linux_x86_64.tar.gz

Configuration

Beehive will generate default config on startup

Supervisord Daemon Setup

Create ~/etc/services.d/beehive.ini with the following content:

[program:beehive]
command=%(ENV_HOME)s/beehive/beehive
autostart=yes
autorestart=yes

After creating the configuration, tell supervisord to refresh its configuration and start the service:

[isabell@stardust ~]$ supervisorctl reread
SERVICE: available
[isabell@stardust ~]$ supervisorctl update
SERVICE: added process group
[isabell@stardust ~]$ supervisorctl status
SERVICE                            RUNNING   pid 26020, uptime 0:03:14
[isabell@stardust ~]$

Finishing installation

Warning

Since beehive does not support any kind of authentication, you need to access it through an SSH tunnel using SSH port forwarding.

To finish the installation, go to http://localhost:8181.

Updates

Update by downloading new binary for x86 64 from https://github.com/muesli/beehive/releases and restarting the service with supervisorctl restart beehive.


Tested on Uberspace U7 with Go v1.15.7, Beehive Version 0.4.0

Written by: momoaux <momoaux@koma666.de>