|Hayden Hughes f37ee1f1d5||2 years ago|
|alerts||2 years ago|
|howl||2 years ago|
|.dockerignore||2 years ago|
|.gitignore||2 years ago|
|Dockerfile||2 years ago|
|LICENSE||2 years ago|
|README.md||2 years ago|
|config.py||2 years ago|
|requirements.txt||2 years ago|
A dead man's switch that sends alerts if a GET request doesn't arrive on time.
DO NOT USE HOWL TO PROTECT ANYTHING IMPORTANT. Howl is extremely alpha and should not be trusted. Howl comes with ABSOLUTELY NO WARRANTY. I am not responsible for any damages.
A service is a platform which can send data like emails or discord. Currently the supported services are:
Adding a service only requires adding a class to
services.py. Refer to
The action of sending a GET request to Howl to notify it that you still exist
is called a
checkin. This requires authenticating with the Howl server using
a username and a password generated by TOTP. Check out
wolf for a cli client to help streamline the
An alert defines when and how to use one or more services. Alerts are
configured by yaml files which are stored in the
The name of the yaml file is the name of the directory. An example alert
timeout: 48 services: - !Email recipient: email@example.com, firstname.lastname@example.org sender: email@example.com subject: Ahh-wooooooo! body: | Hello World! <3 Howl - !Email recipient: firstname.lastname@example.org sender: email@example.com subject: Ahh-wooooooo! body: | Another email from the example alert. <3 Howl
So lets break it down:
timeout:defines how the how long, in hours, to wait since the last check in before the alert is triggered. If
timeoutis set to
Nonethen the alert will only be able to be triggered manually.
services:is a list of the services to use.
docker run -d \ --name howl \ --restart always \ -p 5000:5000 \ -v /srv/howl/:/howl/alerts/ \ -e "USERNAME=test" \ -e "TOTP_SECRET=base32secret3232" \ registry.gitlab.com/huggles/howl
The main application environment variables for configuration.
||Set the log level. Possible values are DEBUG, INFO, WARNING, ERROR or CRITICAL.||
||Used in conjunction with
||A base32 encoded string used to generate the totp password.||Randomly generated.|
||The amount of time in seconds to wait between checking if any alerts should be sounded.||21600|
The email service can be configured with the following environment variables.
||The url to a SMTP server to use for sending emails.||
||The port of the SMTP server used to send emails.||
||The username of the SMTP server.||
||The password of the SMTP server.||
Same as every other docker image:
docker build -t howl .
Go for it!
Howl is distributed under the GNU General Public License Version 3.