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 immensely 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

Check for the latest version on the Beehive release page, then download and unpack that version and move the binary to ~/bin:

[isabell@stardust ~]$ cd ~/tmp
[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]$ mv beehive ~/bin
[isabell@stardust beehive]$

Configuration

Beehive will generate default config in the working directory, we will use the --config flag to store the config file in ~/etc/beehive.conf.

Supervisord Daemon Setup

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

[program:beehive]
command=beehive --config ~/etc/beehive.conf
autostart=yes
autorestart=yes
startsecs=30s

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

Since Beehive does not support any kind of authentication we will not make it public using a web backend but use SSH port forwarding to create a secure tunnel from your local device. To do so, execute the following on your local device:

[you@localhost ~]$ ssh -L 8181:localhost:8181 isabell@stardust.uberspace.de -N -v
[...]
debug1: Connection to port 8181 forwarding to localhost port 8181 requested.

Now you can open http://localhost:8181 in your browser and this will forward to the Uberspace and deliver the Beehive web frontend.

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>