https://github.com/dmitreiro/openvpn-notify
Real-time Telegram notifications when a client connects to an OpenVPN server.
https://github.com/dmitreiro/openvpn-notify
bash linux notify openvpn-notify openvpn-server telegram-bot
Last synced: 3 months ago
JSON representation
Real-time Telegram notifications when a client connects to an OpenVPN server.
- Host: GitHub
- URL: https://github.com/dmitreiro/openvpn-notify
- Owner: dmitreiro
- License: mit
- Created: 2025-02-20T05:24:01.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-21T01:41:40.000Z (over 1 year ago)
- Last Synced: 2025-03-11T17:49:29.150Z (over 1 year ago)
- Topics: bash, linux, notify, openvpn-notify, openvpn-server, telegram-bot
- Language: Shell
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# openvpn-notify
This service sniffs OpenVPN server logs to monitor when a client successfully connects to the server and sends Telegram real-time notifications about the client's name and IP address.
***
## :gear: Setup
:warning: **Warning**: before you proceed, make sure your Linux OS uses `systemd` as a service manager.
Open terminal, change your current working directory to the location where you want the cloned directory and then clone this repository to your local machine
```
git clone https://github.com/dmitreiro/openvpn-notify.git
```
Then, navigate to your repository home folder, give execution permission to `install.sh` and run it as sudo
```
cd openvpn-notify/
chmod +x install.sh
sudo ./install.sh
```
When the installation finishes, edit `/etc/openvpn-notify/config.conf` config file (open as sudo) and write your Telegram bot `token` and `chat_id`.
```
BOT_TOKEN="your_bot_token_here"
CHAT_ID="your_chat_id_here"
```
After setting up config file, restart systemd service to apply changes
```
sudo systemctl restart openvpn-notify.service
```
Now, you are ready to rock :sunglasses:
To check service status run
```
sudo systemctl status openvpn-notify.service
```
To check service logs run
```
sudo journalctl -t openvpn-notify -f
```
## :balance_scale: License
This project is licensed under the MIT License, which allows anyone to use, modify, and distribute this software for free, as long as the original copyright and license notice are included. See the [LICENSE](LICENSE) file for more details.