Skip to content

FAQ

Jump to bottom
Casey Barnett edited this page May 10, 2025 · 1 revision

FAQ ❓

Frequently Asked Questions about StatusZERO

💬 What is StatusZERO?

StatusZERO is a self-hosted dashboard for monitoring IP addresses against major DNS-based blacklists (DNSBLs). It provides fast, token-protected lookups with no API keys or external services.

🔧 How do I add or remove an IP?

Use the Add IP or Remove IP buttons in the interface. You'll need to enter the Admin Token each time.

🔐 Where do I find or change my Admin Token?

The token is stored in config.json (generated at install). To change it:

  1. Edit the value in config.json
  2. Restart the application

📅 How often are IPs checked?

Once daily, at the hour defined by CRON_HOUR in the .env file. You can also trigger manual rechecks anytime.

🛠 What blacklists are used?

StatusZERO checks 18 DNSBLs by default. While lists.txt is included for reference, it is not used for live lookups or configuration. The actual list of supported DNSBLs is embedded into the application logic.

🧪 Can I add my own custom DNSBLs?

Not directly. StatusZERO does not use a user-editable lists file — and lists.txt is for reference only.

If you'd like support for a specific DNSBL, please submit a feature request on GitHub. We will review and test the list for compatibility with our lookup model and add it if feasible.

📤 What data is stored or shared?

None. StatusZERO performs DNS lookups only and stores nothing externally. No usage data is transmitted or logged.

🧠 Why am I seeing "ERROR" for some results?

This usually means:

  • DNS timeout or rate-limiting
  • Resolver configuration issues
  • Temporary blacklist server issues

Try lowering BATCH_LIMIT or changing DNS resolvers in your environment.

💾 Can I export data?

Yes. Click Export CSV to download the current IP status snapshot.

📱 Does StatusZERO work on mobile?

Yes, the UI is fully responsive and supports both light and dark mode.

🛡 Should I expose this to the public internet?

No. It is intended for internal access only. Use a reverse proxy and IP-based access controls to secure it.

Still need help? Open an issue on GitHub or refer to the Security Model and User Guide.

Clone this wiki locally