Skip to documentation

[ Install ]

Install Badger

Choose one method below based on your environment. Complete install first, then verify telemetry and defaults before switching on stricter blocking.

WordPress Dashboard

Best path for most teams and non-CLI environments.

  1. Download the latest package from /downloads/badger-0.1.0.zip.
  2. Open Plugins -> Add New -> Upload Plugin.
  3. Upload the ZIP, activate the plugin, then open Badger from admin menu.
  4. Run the onboarding checklist and confirm trap status is active.

WP-CLI

Recommended for CI/CD pipelines and managed hosting fleets.

  1. Upload plugin zip to the server build artifact path.
  2. Install and activate with WP-CLI commands below.
  3. Trigger a cache flush if your host caches plugin assets.
  4. Open wp-admin and verify the Badger dashboard loads without warnings.

Command

wp plugin install ./badger-0.1.0.zip --activate
wp cache flush

Multi-site rollout

Use network admin and stage in batches to avoid blind spots.

  1. Enable on a staging sub-site first and validate honeypot events.
  2. Network activate only after security headers and robots settings are reviewed.
  3. Apply environment-specific overrides for rate limiting and lockout duration.
  4. Validate detections on one site before network-wide activation.

Command

wp plugin activate badger --network

Bootstrap verification

bash
wp plugin install ./badger-0.1.0.zip --activate
wp option get badger_honeypot_enabled
wp option get badger_security_headers_enabled

Launch verification

  • Install and activate Badger from WordPress dashboard or WP-CLI.
  • Keep honeypot and security headers enabled.
  • Run one test trap hit and confirm it appears in the dashboard.
  • Review configuration defaults before enabling stricter blocking.
  • Use troubleshooting docs if detections or routes do not behave as expected.