← back to the workbench  ·  ler em português (PT-BR)
// project page

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.

released as Elderward at WordCamp Brasil 2026WordPress plugin + CLIGPLv2+not on WordPress.org yet
visit facheiro.space.fast ↗ source on GitHub ↗

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):

install the plugin
cd wp-content/plugins
git clone https://github.com/fcavallari/Facheiro.git facheiro
wp plugin activate facheiro

Then start a scan from the Facheiro admin menu. It runs in the background and changes nothing. To preview fixes from WP-CLI:

preview the signature cleanup
wp facheiro scan --dryrun
preview restoring modified core, plugin and theme files
wp facheiro integrity --restore --dryrun

If the site no longer loads, use recovery mode or the standalone CLI:

every scanner, report-only
php bin/facheiro.php scanall=1 scandirectory=/path/to/wp-root
preview the signature cleanup, write nothing
php bin/facheiro.php dryrun=1 scandirectory=/path/to/site

All 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) or dryrun=1 (standalone CLI).
  • In the standalone CLI, cleanup is the default: with no mode option the script modifies files. dryrun=1 is 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-dir to a path outside the webroot.
  • Nothing leaves the server on its own: the only outbound requests go to wordpress.org during the integrity check.
NOTE TO SELF
New name, same tape. Add sample output and a real changelog when I get to it.