Gatewatch

Русский

Gatewatch sends infrastructure events to Telegram, with a topic per server and optional Fail2ban SSH controls.

Sources → Agent outbox → HTTPS → Hub → Telegram

Custom producers can also post directly to the hub over HTTPS.

Quick start

Debian 12+ or Ubuntu 22.04+, Python 3.10+, a bot and a Telegram forum group. Give the bot Manage Topics and have your numeric Telegram user ID ready.

1. Install the hub:

   git clone --branch v1.2.0 https://github.com/YouRooni/gatewatch.git
   cd gatewatch
   sudo bash scripts/install.sh hub

2. Put the hub behind HTTPS. Use that base URL when creating a node with gatewatch nodes add.

3. Copy the generated config over SSH and run sudo bash scripts/install.sh agent /path/to/agent.secret.json on the node. Install an agent on the hub host too if you want its events.

4. Check the node in /status, then send a synthetic event with gatewatch emit and check its topic.

Full setup and verification · Update and rollback · Security

Notifications

Provider	Features	Setup
Telegram	Topics per node, grouped alerts, inline controls	Telegram

Inputs

Input	Events	Setup
Journal	SSH and Fail2ban	Journal
File	Fail2ban logs	File
CLI / HTTP	Events from scripts and services	Custom events

Actions	Adapter
Ban / unban	Fail2ban

Other channels, sources and actions can be added as plugins. Independent clients can use the HTTP protocol.

Development

Contributing and local checks.

MIT · Author: YouRooni.t.me