minsec minsec

Service status

  • API checking…

    https://api.minsec.io/readyz — enrollment, reports, feed.

  • Blocklist feed checking…

    /v1/feed/basic/v4 — —

  • DNSBL zone checking…

    /v1/dnsbl/v4 — —

The checks above run in your browser against the public endpoints, so they reflect what your network can reach, which may or may not reflect what your server can reach. See minsec-sync(1) for ineracting with minsec.io services from your server(s).

What runs where

ServiceHostPurpose
APIapi.minsec.ioenrollment, report ingestion, feed, DNSBL zone
DNSBLbl.minsec.iocategorised mail blocklist, over DNS
Siteminsec.iothis documentation

If the API is unreachable

Nothing on your server stops working. minsec itself never talks to the network, only minsec-sync does. A failed run:

  • leaves your existing crowd sets in place, unchanged;
  • leaves unreported bans in the events log, to be sent on the next successful run;
  • retries in five minutes.

A 503 feed_not_ready or 503 zone_not_ready means the backend is up but has not finished building a snapshot, usually the minute or two after a deployment. Retry; don't treat it as an empty list.

Reporting a problem

Mail delist@minsec.io for a wrongly listed address, or open an issue at the minsec repository for anything else. Include the output of minsec-sync status if the problem is multiplayer-related; it contains cursors and enrollment state, no log content.