Settings & Tools

Overview

The Settings and Tools tabs in ArmorPro provide global configuration options, diagnostic utilities, data import/export, and maintenance operations. This article covers both tabs in detail.

Settings reference

IP detection

ArmorPro needs to know how to read the visitor's real IP address. By default, it auto-detects the correct header based on your server environment. If your site is behind a reverse proxy or CDN, you may need to select the header manually:

• Auto-detect (default) — ArmorPro checks common headers automatically
• X-Forwarded-For — used by most reverse proxies and load balancers
• CF-Connecting-IP — use this if your site is behind Cloudflare

Debug mode

Enable debug mode for temporary troubleshooting. When active, ArmorPro logs additional diagnostic information that can help identify issues. Debug mode auto-expires after a set period to prevent accidentally leaving it on in production.

Feature toggles summary

Tools tab

The Tools tab provides diagnostic and maintenance operations. Go to ArmorPro → Tools to access these features.

Health checks

Click Run Health Checks to run a comprehensive diagnostic scan. The health check tests:

• Database connectivity
• Table existence and structure integrity
• File permissions (wp-content/armor-waf/)
• Rewrite rules
• License status
• GeoIP database availability
• Plugin integrity

Results are color-coded: green for pass, yellow for warning, and red for error. Include health check results when contacting support to speed up troubleshooting.

Database repair

Click Repair Tables to run CHECK TABLE and REPAIR TABLE on all ArmorPro database tables. This fixes index corruption and structural issues that can occasionally occur after server crashes or unexpected shutdowns.

Test database

Verifies MySQL connectivity and confirms the expected ArmorPro tables are present. Useful for diagnosing connection issues after server migrations.

Export settings

Downloads a JSON file (armor-settings.json) containing all ArmorPro settings, firewall patterns, and whitelist/blacklist entries. Use this to back up your configuration or transfer settings between sites.

Import settings

Upload a previously exported JSON file to restore settings. ArmorPro validates the file structure before importing and merges settings without overwriting user data like logs.

Log exports

Export your security logs as CSV files for external analysis:

• Login log CSV: all login session records
• Firewall log CSV: all firewall block records

Clear all logs

Truncates the login_sessions, blocked_ips, and firewall_log tables. A confirmation dialog is shown before proceeding. This action cannot be undone.

Run cleanup

Manually triggers the log retention cleanup. This expires old log entries based on your tier's retention period (7 days for free, 90 days for Pro). The same cleanup runs automatically via a daily cron job.

Reset settings

Restores all ArmorPro settings to their factory defaults. Your logs, whitelist, blacklist, and firewall patterns are preserved. Only configuration values are reset.

Factory reset

Deletes all ArmorPro data: database tables, options, license activation, and the GeoIP database. This is a complete wipe that returns the plugin to its freshly-installed state.

Load demo data

Generates 90 days of realistic sample data for testing and demonstrations. This creates approximately 200 simulated IP addresses with realistic country distribution: 70% lockout sessions and 30% successful logins. Useful for evaluating the dashboard and log features before going live.

Data retention

A daily cleanup cron job automatically removes log entries older than your tier's retention period. You can also trigger cleanup manually from the Tools tab.