Repository navigation
User Guide
Welcome to the StatusZERO User Guide! This walkthrough will show you how to use the core features of StatusZERO to monitor and manage your IP blacklist health.
When you open StatusZERO, you'll see a dashboard of all monitored IPs. Each IP is displayed in an accordion panel showing:
- Overall Status (CLEAN / LISTED / ERROR)
- Last Checked timestamp
- Blacklist Summary (clean, listed, and error counts)
- Detailed per-blacklist results
Color-coded badges help you identify at a glance:
- Green = CLEAN
- Red = LISTED
- Yellow = ERROR
- Click the "+ Add IP" button at the top right.
- Enter the IP address you want to monitor.
- Enter your Admin Token (generated during install).
- Click "Add IP".
The IP will be added to your dashboard immediately and checked on the next cron run.
💡Tip: You can use the manual re-check option if you need to check the IP before the next cron run!
- Click the red "Remove IP" button inside the IP accordion.
- Confirm the IP address shown.
- Enter your Admin Token.
- Click "Remove IP".
The IP will be removed from the monitoring list.
To trigger a fresh DNSBL check for an IP:
- Click "Manual Re-Check" inside the accordion panel for that IP.
Note: DNS-based results may be cached for a short time depending on resolver behavior.
Click "Export CSV" in the top right to download a current snapshot of all IPs and their blacklist results. This is useful for recordkeeping, audits, or offline analysis.
Use the Search IPs box to filter the dashboard by IP address. The list updates instantly as you type.
Toggle the theme using the switch in the top-right corner. Your preference is remembered between visits using browser storage.
- Forgot your Admin Token? Check your
.envfile. - Seeing errors? Visit the FAQ for troubleshooting steps.
StatusZERO makes it easy to keep your network reputation clean and under control.
For more advanced options, see the Advanced Configuration guide.
Happy monitoring! 🛡️