Skip to main content
Curator’s upstream dependencies (PHP, Apache, and MariaDB) require periodic updates to maintain security, performance, and compatibility with the latest Curator features. Note: Before upgrading any dependencies, it is a good idea to ensure that you have a recent Curator backup available.

​
PHP Dependencies by Curator Version

​
Important Notes

  • Always ensure your PHP environment meets or exceeds the minimum version requirement for your Curator installation.
  • Installing a PHP version above the listed maximum is unsupported and causes runtime errors. Stay within the minimum/maximum range shown for your Curator release.
  • Upgrading Curator may require upgrading your PHP version. The System Upgrade page will automatically warn you when a release requires a newer PHP version than your server is currently running. See System Upgrade — PHP Version Compatibility for details on how these warnings appear.
  • Check your current PHP version with php --version.

​
Required PHP Extensions

Running a supported PHP version is not enough on its own — Curator also requires the following PHP extensions to be enabled in that version: Curator checks for these extensions and, on self-hosted installations, raises a Curator is missing one or more dependencies warning that links back to this page when any of them are unavailable. Upgrading PHP with the Curator Dependency Update Utility on Windows, or with the php_upgrade_util.sh script on Linux, enables the required extensions for you. Installing or upgrading PHP manually does not — for example, downloading a PHP release yourself and pointing IIS or Apache at it. In that case you must enable each extension in the new PHP version’s php.ini. To list the extensions the PHP command line currently loads:
To check for a single extension, filter that list with php -m | findstr zip on Windows, or php -m | grep zip on Linux.
If php artisan commands fail immediately after a manual PHP upgrade with an error such as Class "ZipArchive" not found, the zip extension is not enabled in the PHP version now in use. Add extension=zip to the php.ini file that php --ini reports as loaded, then restart your web server and any PHP FPM processes. Reverting to the previous PHP version also clears the error, because the old installation still has the extension enabled.

​
Database Dependencies by Curator Version

Starting with 2026.06-01, Curator requires a newer database engine. Older MySQL and MariaDB versions are no longer compatible with the underlying framework, so the System Upgrade process will refuse to install a release that requires a database version newer than the one your server is running.

​
Database Notes

  • Always ensure your database engine meets or exceeds the minimum version requirement for your Curator installation.
  • Upgrading Curator may require upgrading your database. The System Upgrade page will automatically block a release when it requires a newer database version than your server is currently running. See System Upgrade — Database Version Compatibility for details on how this appears.
  • Check your current database version by running SELECT VERSION(); against your Curator database, or mysql --version from the command line.
  • See the Optional MariaDB Upgrade and Manual MariaDB Updates sections below for instructions on upgrading MariaDB.

​
Windows

First and foremost: ensure all relevant Windows Updates have been applied to your server. Next, update Curator dependencies. Curator bundles PHP, Apache, and VC Redistributable upgrades (plus an optional MariaDB upgrade) into a simple utility package to make updating them as easy as possible. To update Curator’s dependencies, simply download our Curator Dependency Update Utility. Once downloaded, simply double-click the utility to run updates. The Microsoft Visual C++ Redistributables, PHP, and Apache will be upgraded automatically by this utility. During the upgrade, the utility pauses Curator’s scheduled jobs and stops any running PHP processes so files are not locked mid-upgrade, then resumes everything once the upgrade finishes. Note: Internet access is required for this process. Systems without internet access will need to upgrade manually.

​
Optional MariaDB Upgrade

The utility can also upgrade Curator’s bundled MariaDB database. Because the database is stateful, this step is off by default: the utility asks whether you want to run it, and the prompt only appears when a Curator MariaDB installation (libs\MariaDB) and the CuratorDB service are both present on the server. If you opt in:
  • You will be prompted for your database root password, which is validated against the running server before anything is changed. The password is saved in the info.txt file in your installation directory (typically C:\InterWorks\Curator\info.txt) under Database Root Password.
  • The utility takes a full backup of the libs\MariaDB folder as a rollback point. A disk-space check runs first to confirm there is enough room for the backup.
  • Only the MariaDB program files are replaced. Your databases (the data folder) and configuration (my.ini) are never touched.
  • If the upgrade crosses major MariaDB versions, the utility warns you and asks for confirmation before proceeding.
  • After the new version starts, the utility runs mysql_upgrade and verifies the result.
  • If the new version fails to start or verification fails, the previous MariaDB installation is automatically restored from the backup.
After a successful upgrade, the backup folder (for example, libs\MariaDB.old) is kept on disk. Once you have confirmed Curator works correctly, you can delete it to reclaim disk space. Note: The database briefly stops during this step, and upgrading MariaDB is not usually required for a Curator upgrade. Only opt in when a release requires a newer database version (see Database Dependencies by Curator Version) or you have another reason to upgrade. Always have your own recent backup before upgrading the database.

​
Manual Dependency Updates

If your server has restrictions that prevent the utility from downloading files automatically, you can manually download the required files and run the upgrade utility locally. To manually upgrade dependencies:
  1. Download the Curator Dependency Update Utility on a system with internet access.
  2. Download the following files to the same directory as the utility.
    File names must match exactly as shown below for the utility to recognize them.
  3. Transfer all files (the utility and the downloaded files) to your Curator server.
  4. Ensure the utility and all downloaded files are in the same directory, such as having them all on your Desktop, then double-click the utility to run the upgrade.
Note: The utility will detect the locally available files and use them instead of attempting to download them. If the file names do not match exactly, the utility will not recognize them and will attempt to download them from the internet.

​
Manual MariaDB Updates

The Optional MariaDB Upgrade step in the Dependency Update Utility is the recommended way to upgrade MariaDB on Windows, since it backs up the installation and automatically rolls back if the upgrade fails. Use the manual steps below only if you cannot run the utility. To manually upgrade MariaDB, download the MariaDB package. Note: To upgrade MariaDB, you will need your database root password. If you do not know this password, check your installation directory for an info.txt file (typically C:\InterWorks\Curator\info.txt) and look for the Database Root Password entry.

​
MariaDB on Windows

To upgrade MariaDB on Windows, first stop the CuratorDB Service, using Window’s Services app. You can open Window’s Services by simply searching for Services using the Window’s start bar. To stop the CuratorDB process, find it in the Services list, then right click on it and click Stop. Next, find Curator’s MariaDB installation folder. Note: This can usually be found in C:\InterWorks\Curator\libs\MariaDB. Rename to MariaDB’s bin folder to bin.bkp. After a successful upgrade, you can delete this backup directory. Then, download the latest MariaDB package. Unzip this package over top of Curator’s MariaDB installation. Finally, open PowerShell in Administrative mode and run MariaDB’s upgrade utility. To open Powershell in Administrative mode, use the search widget in Window’s start bar. Search for Powershell, then Right-Click on Powershell and click “Run As Administrator”. Navigate to MariaDB’s bin directory and run the upgrade utility.
Note: if you have trouble with the MariaDB’s service upgrade utility, you can also use the non-service version. To do this, first restart MariaDB in Window’s Services app, and then run this command:

​
Linux

Linux’s upstream repositories handle dependency updates, so first ensure you are running a recent version of your Linux distribution. If you’re not sure, you can take a look at our recommended distributions on the Linux Installation page. To update Curator’s Linux dependencies, SSH into your web server and cd into the webroot directory (typically /var/www/html) and ensure you’re using a user that has full sudo access, and run the command below. This command will upgrade PHP, MariaDB, Apache, and any other operating system dependencies required by Curator: