WireGuard Client Connection Notification

Receive notifications via Telegram or Gotify whenever a client connects or disconnects from a WireGuard tunnel.

Installation and Setup

Follow these steps to set up the notification service on your WireGuard server.

1. Clone the Repository

Start by cloning this repository onto your server:

git clone git@github.com:HectorBravo/wireguard-notifier.git

2. Configure the Service

1. Rename the configuration file template:

   mv .config-example .config

2. Edit the .config file to include your notification settings. Make sure to configure either Telegram or Gotify server details.

3. Set Up Permissions and Schedule the Script

1. Add the script to the root user's cron job to run it periodically. Elevated privileges are required to access WireGuard tunnel information.

   • Open the root crontab editor:

     sudo nano /etc/crontab

   • Add the following line to execute the script every minute, replacing the correct path to the repo directory

     * * * * * root cd /path/to/wireguard-notifier && /path/to/wireguard-notifier/wg-clients-guardian.sh /path/to/wireguard-notifier/.config > /dev/null 2>&1

4. Start Receiving Notifications

Once everything is set up, the script will check for client connections or disconnections every minute and send a notification through your configured method.

Acknowledgements

This project was inspired by and built upon the work done by alfiosalanitri. This new version supports configurations generated by wireguard_ui and also allows whitelisting of certain clients so those will not generate notifications