Documentation
Install minsec, get a first ban, then decide how much of the crowd you want.
New here? Install the package, then follow the quick start — about five minutes to a running daemon with a dry run first, so nothing touches your firewall until you say so.
Getting started
Install
During the beta, .rpm and a .deb packages are available on the GitHub release page. Dependencies are minimal — systemd and, for …
Quick start
This assumes minsec is installed and not yet running. 1. See what would happen, first Before enabling anything, you can test on an …
Using minsec
Configuration
One TOML file, plus drop-ins.
Filters
Built-in filters for the usual services, and fail2ban-shaped regexes for everything else.
Firewall & backends
What minsec creates The nft backend owns table inet minsec and touches nothing outside it: Object Contents set ban4 / ban6 local …
Web UIs
Virtualmin minsec ships with Virtualmin and replaces its fail2ban integration. Nothing to install: the daemon, the filters for the …
Troubleshooting
Nothing is banned Work down this list; each step is offline or harmless. 1. Is the filter matching at all? minsec test sshd …
Multiplayer
Multiplayer mode
Report your bans; pull crowd-sourced bans.
Blocklist feed
minsec-sync pull handles this for you. This page is for people who want to consume the feed directly — into a router, a CDN rule, …
DNSBL for mail
A firewall feed and a mail blocklist want different things from the same observations. Dropping an attacker's packets because they …
Reference
API
Base URL: https://api.minsec.io. All request and response bodies are JSON unless stated otherwise. Errors are: {"error": …
Service status
API checking… https://api.minsec.io/readyz — enrollment, reports, feed. Blocklist feed checking… /v1/feed/basic/v4 — — DNSBL zone …
Manual pages
The manual pages installed by the minsec packages, published verbatim.
minsec(1)minimalist log-driven intrusion prevention daemon and control utility
minsec-sync(1)report local minsec bans and maintain the crowd blocklist
minsec.toml(5)minsec daemon configuration and drop-in format
minsec-filter.toml(5)minsec log-source and matching-filter definition format
minsec-sync.toml(5)minsec multiplayer client configuration