# Mailcow-Ban-Check

This Bash script monitors a remote IP ban list, compares it with previously tracked IPs in SQLite, records changes, and sends notifications to a Discord-compatible webhook

# Still in development
# Not for Production

## !!! Important: the URLs placed into this script will contain credentials/access tokens or API Keys. Treat this script as sensitive. These credentials will be stored in a more secure way in a future update !!!

A Bash-based monitoring tool that tracks changes to a remote IP ban list.

The script downloads a ban list, compares it with previously tracked addresses in a local SQLite database, records new bans and removals, and sends notifications to a Discord-compatible webhook.

### Features

- Downloads a remote ban list over HTTPS
- Supports IPv4, IPv6, and CIDR notation
- Removes duplicates and surrounding whitespace
- Tracks active and inactive IP addresses
- Maintains a ban history
- Sends notifications for:
  - Newly banned IPs
  - IPs removed from the ban list
- Prevents overlapping executions with `flock`
- Supports cron and systemd timer execution
- Provides commands for viewing history, statistics, and active bans

### Requirements

The following commands must be installed:

- Bash
- `curl`
- `sqlite3`
- `jq`
- `flock`
- `awk`
- `sort`
- `comm`
- `date`
- `wc`


## !!! Important: the URLs placed into this script will contain credentials/access tokens or API Keys. Treat this script as sensitive. These credentials will be stored in a more secure way in a future update !!!