+- AdminsForum (https://adminsforum.com)
+-- Forum: Free & open-source control panels (https://adminsforum.com/Forum-free-open-source-control-panels)
+--- Forum: aaPanel (https://adminsforum.com/Forum-aapanel)
+---- Forum: aaPanel Guides & Tutorials (https://adminsforum.com/Forum-aapanel-guides-tutorials)
+----- Forum: aaPanel PHP & Extensions Guides (https://adminsforum.com/Forum-aapanel-php-extensions-guides)
+----- Thread: Guide Install PHP Imagick in aaPanel and Verify WordPress Detects It (/Thread-guide-install-php-imagick-in-aapanel-and-verify-wordpress-detects-it)
Install PHP Imagick in aaPanel and Verify WordPress Detects It - DEV - 10-12-2026
How do you install Imagick for WordPress on aaPanel?
Confirm the PHP version used by your website. In aaPanel’s App Store, open that PHP version’s Setting → Install extensions and install the row named imagemagick. Wait for compilation to complete, then verify WordPress Site Health → Info → Server reports the Imagick library as available.
We tested this on aaPanel 8.0.6 Free Edition with PHP 8.5.11 and WordPress 7.1.3. The panel installed Imagick 3.8.1. WordPress detected it, and a separate command-line test created a 64 × 64 image, resized it to 32 × 32 and encoded a PNG successfully.
Imagick and ImageMagick are related but different names
ImageMagick is the underlying image-processing library/toolset. Imagick is the PHP extension that exposes its functionality to PHP applications. Our aaPanel extension row was named imagemagick, while WordPress referred to the missing PHP module as imagick. Installing the operating system’s command-line image tool alone is not proof that the website’s PHP runtime has its extension loaded.
1. Confirm the WordPress warning
Open WordPress → Tools → Site Health, let the checks finish and expand the missing-module recommendation. After our earlier EXIF installation, the remaining optional-module warning named imagick.
The remaining Imagick warning before installation.
Optional-module advice is different from a fatal website error. Install the extension for a clear requirement and verify it afterward; do not assume every warning needs a broad server reconfiguration.
2. Check the website’s PHP version
Use Site Health → Info → Server to read the actual PHP version, or verify the site’s PHP selection in aaPanel. Our site used PHP 8.5.11. The server also had PHP 8.4, so we deliberately selected the 8.5 manager.
Take a current backup and choose an appropriate maintenance period on a live server. A PHP extension installation may reload or restart that PHP version’s service and affect other sites using it.
3. Install the matching extension
In aaPanel select App Store → Installed. Find PHP-8.5 for this example and choose Setting. Open Install extensions.
Locate imagemagick, described in our list as Imagick High Performance Graphics Library. Click Install in that row and confirm Install【imagemagick】 after checking the PHP version and extension name.
The row displayed Installing while the job ran. Compilation takes time; do not submit duplicate installs or judge success from a pending status. Read the installation task/log if it fails or stops progressing.
4. Confirm the installed state
After the job finished, we reopened the PHP manager and extension list. The imagemagick row offered Uninstall, showing that the installed module was recognised by the panel.
The refreshed PHP 8.5 extension list after installation.
If a refresh briefly leaves the table blank, reopen the manager after the task has completed. Do not treat an empty table as proof of either success or failure.
5. Verify WordPress uses it
Return to WordPress Site Health and let the checks complete. In our test, the missing-module recommendation disappeared. We then opened Info → Server and checked Is the Imagick library available?. It reported Yes.
WordPress’s own runtime reports that Imagick is available on PHP 8.5.11.
A command-line check alone is not enough if CLI and the website use different PHP configurations. WordPress’s result confirms availability to the website. Our remaining recommendations concerned inactive plugins/themes; this installation does not claim to fix unrelated maintenance findings.
6. Verify a basic image operation
We also ran a small private command-line test with the exact aaPanel PHP binary. It reported EXIF loaded, Imagick loaded and extension version 3.8.1. It created and resized a test image, then produced a non-empty PNG blob.
Our functional test returned 32 × 32 pixels and 160 PNG bytes.
For administrators who want a basic version-specific availability check:
Code:
/www/server/php/85/bin/php -r 'echo extension_loaded("imagick") ? "Imagick loaded
" : "Imagick missing
";'A small PNG test does not prove that every image type, large upload, PDF delegate or animation workflow works. Verify the formats and operations your application actually needs.
Troubleshooting
- Installed in panel but WordPress still says missing: compare the website’s selected PHP version and loaded configuration with the version you changed.
- Compilation fails: inspect the actual build error, dependencies, memory/disk availability and source connectivity before retrying.
- Imagick loads but a format fails: review support and policy for that specific operation. Do not broadly disable ImageMagick security policies just to suppress an error.
- WordPress image upload still fails: check the upload limit, file type, permissions and exact application error. Imagick availability does not resolve every media problem.
Verified outcome
The panel recognised imagemagick as installed, WordPress reported Imagick available and the private image resize/PNG test passed. EXIF stayed loaded. No other PHP version was changed, and no public diagnostic endpoint was created.
References: PHP Imagick manual, our EXIF guide and our Site Health guide. Screenshots and tests are from the AdminsForum lab.