Facheiro
Elderward is now Facheiro. Same project, new name. It was publicly released as Elderward at WordCamp Brasil 2026, and the old GitHub address now redirects to the Facheiro repository.
A free malware scanner and incident-response toolkit for WordPress sites. It finds signs of compromise, removes known malware, checks core, plugins and themes against wordpress.org, scans the database, and reads access logs for known indicators of compromise, so you can see how the attack happened.
what_it_is
Facheiro started as a variation of the Jetpack Cleanup Util, packaged so anyone can run it on their own host. It runs four ways, all on the same engine:
- WordPress plugin: admin pages under its own Facheiro menu.
- WP-CLI:
wp facheiro .... - Recovery mode:
recovery.php, for when WordPress no longer loads but the server still runs PHP. - Standalone CLI:
php bin/facheiro.php ..., with no working WordPress needed.
The name comes from the facheiro, a cactus of the Brazilian caatinga: in the dry season the sertanejo burns its thorns off, and what is left is water and feed.
what_it_does
- A report-only scan of everything from the admin, in the background or on a schedule, with findings worst-first and NDJSON export.
- Custom signatures, written and tested in the admin (detection only).
- Server hardening for Apache/LiteSpeed and Nginx, with a health check and automatic rollback on Apache/LiteSpeed.
- Recovery mode: a key-protected page that works when WordPress itself does not load.
- AI assistant tools over MCP that run scans and explain findings, and never clean or change files.
- Cleanup and restore from WP-CLI or the standalone CLI, with a dry run first.
- Admin and recovery pages in Brazilian Portuguese and English.
try_it
The plugin needs WordPress 6.0+ and PHP 7.2+; the standalone CLI and recovery mode run on PHP 5.6+. It is not on WordPress.org yet, so install it from GitHub (the folder must be named facheiro):
cd wp-content/plugins
git clone https://github.com/fcavallari/Facheiro.git facheiro
wp plugin activate facheiroThen start a scan from the Facheiro admin menu. It runs in the background and changes nothing. To preview fixes from WP-CLI:
wp facheiro scan --dryrunwp facheiro integrity --restore --dryrunIf the site no longer loads, use recovery mode or the standalone CLI:
php bin/facheiro.php scanall=1 scandirectory=/path/to/wp-rootphp bin/facheiro.php dryrun=1 scandirectory=/path/to/siteAll the options, the output format and the exit codes are in the reference.
read_before_cleaning
- Back up first, and preview with
--dryrun(WP-CLI) ordryrun=1(standalone CLI). - In the standalone CLI, cleanup is the default: with no mode option the script modifies files.
dryrun=1is what makes it report-only. - A clean scan does not prove a clean site. Facheiro finds and removes known malware and reports common backdoor shapes.
- Restoring overwrites files. The README’s restore example sets
--quarantine-dirto a path outside the webroot. - Nothing leaves the server on its own: the only outbound requests go to wordpress.org during the integrity check.
New name, same tape. Add sample output and a real changelog when I get to it.