Server checks performed by the built-in TruCMS installer.
TruCMS checks the server before installation because missing PHP features or unwritable working folders can cause failures later when uploading media, sending requests to external services, processing images, or writing cached application data. It is much easier to correct the hosting environment before entering your database and administrator details.
| Requirement | What you need | Why TruCMS needs it |
|---|---|---|
| PHP | PHP 8.4 or later | Required by the installed TruCMS application and checked before setup continues. |
| PHP extensions | cURL, BCMath, Ctype, Fileinfo, JSON, Mbstring, PDO, Intl, OpenSSL, Tokenizer, XML, EXIF and GD | These support common application functions such as secure connections, text handling, database access, localization, file inspection and image processing. |
storage | Writable by the web-server user | TruCMS needs to write application-generated files here. |
bootstrap/cache | Writable by the web-server user | TruCMS needs to maintain generated cache files here. |
| Database | A MySQL/MariaDB-compatible database and account | The installer asks for host, port, database name, username and password during Application Setup. |
Check before uploading customer data
If you are using managed hosting, send this list to the hosting provider before installation. Ask them to confirm both the PHP version and extensions for the actual domain, because the command-line PHP version can differ from the web-server version.
Installer Step 1 presents the checks as pass/fail items. A failed item is not a content or account problem; it means the hosting environment still needs attention. Correct the server setting, reload the requirements step, and continue only after the required checks pass.
Once the hosting environment meets these requirements, continue with Preparing Your Server to configure the domain, HTTPS, document root and permissions.