Skip to content

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📬 miab-radar

High-signal health, deliverability and security diagnostics for Mail-in-a-Box

Bash 4+ Mail-in-a-Box Active License

Quick Run · Coverage · Automation · Exit Codes


⚡ Quick Run

git clone https://github.com/Anton-Babaskin/miab-radar.git
cd miab-radar
chmod +x miab-radar.sh
sudo ./miab-radar.sh

Inspect a wider 48-hour log window:

sudo ./miab-radar.sh 48

Note

Run directly on the Mail-in-a-Box host. The tool is terminal-first, dependency-light and focused on actionable findings.

🎯 What it is for

miab-radar turns Mail-in-a-Box service state, queues, logs, DNS, TLS and security signals into a prioritized OK / WARN / FAIL view. It is built for operational troubleshooting—not dashboards or long-term metrics storage.

🔭 Coverage

Area Signals
📮 Mail flow active/deferred/stuck queue, bounces, deferrals, senders, recipients and SMTP behavior
🌐 DNS & reputation MX, SPF, DKIM, DMARC, PTR and common DNSBL checks
🔐 Security Fail2Ban, brute-force signals, SSH posture and open-relay protection
🔒 TLS SMTP, IMAPS and HTTPS certificates, expiry and STARTTLS
🖥️ Host health Postfix/Dovecot/Nginx services, disk, inodes, mailboxes and backup freshness

📦 Optional global install

sudo ./install.sh
sudo miab-radar

The installer copies the executable to /usr/local/bin/miab-radar.

⏱️ Automation

Example cron entry for a 30-minute health snapshot:

*/30 * * * * /usr/local/bin/miab-radar > /var/log/miab-radar.log

For automation, consume the exit code and preserve the full report for diagnosis.

Exit Codes

Code Meaning
0 All checks passed
1 Warnings are present
2 Critical findings detected

Requirements

  • Mail-in-a-Box on Ubuntu/Debian
  • Bash 4+
  • Root privileges for full logs and service visibility
  • Standard system and DNS utilities used by Mail-in-a-Box

Project philosophy

  • Bash: deterministic, inspectable checks
  • Logs: the source of truth for mail flow
  • Output: concise findings with next actions
  • Overhead: no agents, database or heavy runtime

Related tools

License

MIT — see LICENSE.

Author

Anton Babaskin

Releases

Packages

Contributors

Languages