BugWP logo BugWP
Back to Community
Home / Community / Plugin → Ewww image optimizer

Resolving 'Missing' Tool Errors in EWWW Image Optimizer

48 threads Sep 10, 2025 Plugin → Ewww image optimizer

Content

If you use EWWW Image Optimizer, you've likely encountered a frustrating message stating that tools like jpegtran, optipng, or gifsicle are "missing," even when the files appear to be in the correct folder. This is a common support issue, and this guide will walk you through the most frequent causes and their solutions.

Why This Error Occurs

The EWWW Image Optimizer plugin relies on several command-line tools to optimize images. The "missing" error means the plugin cannot locate or successfully execute these necessary binaries. This is rarely because the files are actually gone; more often, it's due to one of the following issues:

  • File Permissions: The web server user (e.g., www-data) does not have permission to read or execute the files.
  • Binary Incompatibility: The pre-compiled tools provided by the plugin are not compatible with your server's operating system or architecture.
  • Transfer Mode: If the plugin was uploaded via FTP in ASCII mode instead of Binary mode, the tool files can become corrupted.
  • Hosting Restrictions: Some managed hosting providers disable the exec() PHP function for security reasons, preventing the plugin from running any external tools.

How to Troubleshoot and Fix the Issue

1. Check and Correct File Permissions

The most common fix is to ensure the wp-content/ewww/ folder and the files within it have the correct permissions. The web server must be able to read and execute the files.

  • Folder Permissions: The wp-content/ewww/ directory should be set to 755 (or 775 if necessary).
  • File Permissions: The individual tool files (e.g., jpegtran, optipng-linux) should be set to 755.

You can typically adjust these permissions using your hosting control panel's file manager or an FTP client.

2. Verify Binary Compatibility

The EWWW Image Optimizer team provides tools pre-compiled for common Linux distributions. If you are on a less common OS like FreeBSD or an older/unusual Linux distribution, the bundled tools may not work.

  • Check Your OS: Contact your hosting provider to confirm your server's operating system and architecture (e.g., FreeBSD 12, Ubuntu 18.04, x86_64).
  • Install Custom Binaries: If the bundled tools are incompatible, you can compile or obtain compatible versions of the tools yourself. Place them in the wp-content/ewww/ folder. For cwebp, you may need to name a custom version cwebp-custom for the plugin to recognize it.

3. Reinstall the Plugin Correctly

If you installed the plugin via FTP, the file transfer mode may have corrupted the binaries.

  • Delete the wp-content/ewww/ folder and the ewww-image-optimizer plugin folder.
  • Reinstall the plugin directly through your WordPress admin dashboard (Plugins > Add New). This is the most reliable method.
  • If you must use FTP, ensure your FTP client is set to BINARY transfer mode before uploading the plugin's ZIP file or its contents.

4. Confirm exec() is Enabled

The plugin requires the PHP exec() function to be enabled. Many managed WordPress hosts disable this function.

  • Check your EWWW settings page. Under "Plugin Status," it should say "exec(): Enabled."
  • If it is disabled, you must contact your hosting provider and ask if they can enable exec() for your account. Be aware that some providers will not enable it for security reasons.

5. Review Debug Information

For advanced troubleshooting, the debug information is invaluable.

  1. Go to the EWWW Image Optimizer settings in your WordPress admin.
  2. Enable the "Debugging" option and save settings.
  3. Scroll down, and you will find a large text area filled with system information.
  4. This log shows the exact permissions of the ewww folder, the paths the plugin is checking, and any errors it encounters when trying to run the tools. Sharing this information can help pinpoint the exact issue.

When All Else Fails

If you have confirmed permissions are correct, the tools are compatible, and exec() is enabled, but the error persists, the issue may be a deeper server configuration. In these cases, your best course of action is to provide the detailed debug information to your web host's support team and ask them to investigate why the web server cannot execute the files in the ewww directory.

Remember, you do not need every tool for the plugin to function. If you are only optimizing JPEGs, having jpegtran working is sufficient. You can disable warnings for other tools in the Advanced settings to clean up the admin notice.

Related Support Threads Support