Sends alerts for any arbitrary CTFd instance via ntfy

You can download a pre-built binary from the releases or you can use the following options

# Go
go install github.com/taciturnaxolotl/ctfd-alerts@latest

If you need a systemd service file there is one in ctfd-alerts.service

# Direct installation with flakes enabled
nix profile install github:taciturnaxolotl/ctfd-alerts

For use in your own flake:

# In your flake.nix
{
  inputs.ctfd-alerts.url = "github:taciturnaxolotl/ctfd-alerts";

  outputs = { self, nixpkgs, ctfd-alerts, ... }: {
    # Access the package as:
    # ctfd-alerts.packages.${system}.default
  };
}

The config for the bot is quite simple. Create a config.toml file in the same directory as the binary (or link to the config location with -c ./path/to/config/config.toml) with the following format:

debug = true
interval = 100 # defaults to 300 if unset
user = "echo_kieran"

[ctfd]
api_base = "http://163.11.237.79/api/v1"
api_key = "ctfd_10698fd44950bf7556bc3f5e1012832dae5bddcffb1fe82191d8dd3be3641393"

[ntfy]
api_base = "https://ntfy.sh/"
acess_token = ""
topic = "youralert"

Written in go. If you have any suggestions or issues feel free to open an issue on my tangled knot

© 2025-present Kieran Klukas