https://docs.whmcs.com/9-1/tags/updates/Recent content in updates onHugo -- gohugo.iohttps://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/troubleshooting-updates/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/troubleshooting-updates/Index page linking to update-check, update failure, automatic-update, and post-update troubleshooting articles for the WHMCS update process.https://docs.whmcs.com/9-1/system/updates/updating-whmcs/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/updating-whmcs/Covers checking for and applying updates via Update Now, the automatic-update PHP requirements, unattended automatic updates for maintenance releases, the Stable/Current Version/Release Candidate/Beta Update Channel options, the Temporary Update Path and Maintenance Message settings, which files updates overwrite (language files, default templates, WHMCS-supplied modules, core files), and the tblupdatelog troubleshooting table.https://docs.whmcs.com/9-1/installation-guide/set-up-a-test-environment/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/installation-guide/set-up-a-test-environment/Walks through creating a WHMCS test environment: getting a development license, duplicating the installation and database, password-protecting the directory, updating the System URL, disabling email sending, and truncating client data tables before going live.https://docs.whmcs.com/9-1/system/updates/unattended-automatic-updates/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/unattended-automatic-updates/Covers unattended automatic updates for maintenance releases, including system requirements, the Update WHMCS, Modify Update Configuration, and Unattended Automatic Updates administrator role permissions, where to configure the schedule’s frequency, day, and time, the Update History table and its Scheduled, In Progress, Completed, and Failed statuses, the Admin Area and email notifications after each attempt, the backup of replaced files that the system creates before each update and the automatic restore after a failure, the retry behavior of up to three attempts, and where WHMCS logs the failure reason for troubleshooting.https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/admin-directory-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/admin-directory-errors/Resolves admin directory conflict errors such as “accessing the admin area via a directory that is not configured” by verifying the correct URL, setting the $customadminpath value in configuration.php, uploading updated files to a custom admin directory and deleting the default admin folder, or reverting the admin directory name to admin.https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/blank-admin-dashboard/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/blank-admin-dashboard/Fixes a blank Admin Dashboard with widgets that will not load after an update, caused by mismatched MySQL table collation values (e.g. latin1_general_ci vs latin1_swedish_ci on tblorders and tblorderstatuses), diagnosed via SQL Debug and System Logs and resolved with an ALTER TABLE CONVERT TO CHARACTER SET command.https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/curl-timeout-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/curl-timeout-errors/Covers “Curl Error - 28 connect() timed out” and “cURL error 28: Operation timed out” during server provisioning (busy server, 150-second provisioning limit, IP mismatch) or the Automatic Updater downloading from releases.whmcs.com, with fixes for firewalls, SSL mode under Servers settings, and retrying updates via the browser or command line.https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/down-for-maintenance-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/down-for-maintenance-errors/Troubleshoots the Down for Maintenance (Err2) error caused by a mismatch between database, WHMCS file, and PHP versions, with separate resolution steps for when the error appears during an in-progress update (browser install.php upgrade process) versus after an update that did not complete or apply correctly.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/fatal-error-fetching-update/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/fatal-error-fetching-update/Covers “A fatal error occurred while fetching the update” during Automatic Updater use, with troubleshooting steps using the browser network analyzer, checking PHP version requirements and server timeout settings, and testing PHP execution length with test_execution_time.php.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/file-download-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/file-download-errors/Covers “failed to open stream: operation failed” and SSL3_GET_SERVER_CERTIFICATE certificate verification failures during Automatic Updater downloads, caused by an outdated CA bundle or an open_basedir restriction, with fixes and a workaround of disabling open_basedir.https://docs.whmcs.com/9-1/system/updates/legacy-module-removal/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/legacy-module-removal/Legacy Module Removal explains how WHMCS automatically inspects for and removes unused legacy modules during the update process to prevent problems caused by older PHP code. Legacy modules are deprecated payment gateway, domain registrar, server and provisioning, addon, fraud, and support modules that WHMCS no longer maintains or distributes. This page describes the inspection process, the deletion and notification logic for modules that are in use, successfully deleted, or that fail to delete (including the log messages the system records and the notifications it sends to admins), and links to the manual removal steps for each module type. It also explains why a configured deprecated module remains active after an update because its stored configuration is not removed, and how to migrate to a supported alternative and then manually delete the leftover module files.https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/update-customizations-manually/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/customization/client-area-customization-tutorials/update-customizations-manually/Walks through manually applying template changes before a version update: checking Release Notes, comparing files in templates/template_name, replacing changed lines, and clearing the template cache via Utilities > System > System Cleanup.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-whmcs-cloud/missing-features-on-whmcs-cloud/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-whmcs-cloud/missing-features-on-whmcs-cloud/Explains why Database Backups, Storage Settings, and Update WHMCS permissions and interfaces are unavailable on WHMCS Cloud installations, attributing it to WHMCS Cloud automatically managing those functions, and confirms this is expected behavior.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/network-issue-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/network-issue-errors/Documents “Network Issue - Failed Communication with Update Server” and “Unable to connect to the WHMCS Update Server” caused by the server failing to reach WHMCS’s update servers, with curl commands to test connectivity to releases.whmcs.com and pki.whmcs.com.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/new-version-not-appearing/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/new-version-not-appearing/Explains why the newest WHMCS release doesn’t appear when checking for updates, covering a page that hasn’t refreshed, an excluded Update Channel setting, or unmet system and PHP requirements, with fixes for each cause.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/no-existing-installation-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/no-existing-installation-errors/Documents “no existing installation was detected” and “WHMCS Not Installed Error” during upgrades, caused by a missing, unreadable, or malformed configuration.php file, with steps to verify the file’s location, permissions of 444, and database detail formatting.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/update-dry-run-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/update-dry-run-errors/Documents “Apply update dry-run detected x permission issues” caused by incorrect file or directory permissions found during the update’s pre-check, with the fix of correcting permissions and ownership on the listed paths.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/update-failed-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/update-failed-errors/Covers the general “Update Failed” error with a reference table mapping specific RuntimeException and ErrorException sub-messages, including timeouts, permission issues, disk quota, chmod failures, and an invalid temporary update path, to their individual fixes.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/update-message-validation-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-updates/update-message-validation-errors/Documents “Update Message Validation Issue” caused by failing cryptographic signature validation from outdated CA bundles, outdated OpenSSL, PHP configuration issues, or a possible Man-in-the-Middle attack, with a sequence of checks and re-checks for updates.https://docs.whmcs.com/9-1/system/updates/update-tutorials/check-for-updates/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/check-for-updates/Gives the steps to manually check for a new WHMCS version by clicking Check Now on the Update WHMCS page, and what the An update is available message indicates about the current Update Channel and system requirements.https://docs.whmcs.com/9-1/system/updates/update-tutorials/prepare-to-update-whmcs/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/prepare-to-update-whmcs/Lists the recommended pre-update checklist for self-hosted WHMCS installations: reviewing release notes for the target and intermediate versions, checking system requirements, protecting custom themes and order form templates with dedicated directories or override files, testing updates in a non-production environment, backing up the database and directory, and confirming MySQL permissions.https://docs.whmcs.com/9-1/system/updates/update-tutorials/schedule-automatic-updates/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/schedule-automatic-updates/Gives the steps to enable Apply Automatic Updates and set the frequency, day, and time under Configure Update Settings on the Update WHMCS page.https://docs.whmcs.com/9-1/system/updates/update-tutorials/set-a-maintenance-message/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/set-a-maintenance-message/Gives the steps to enter a Maintenance Message under Configure Update Settings on the Update WHMCS page, noting the Modify Update Configuration admin role permission required.https://docs.whmcs.com/9-1/system/updates/update-tutorials/set-the-temporary-update-path/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/set-the-temporary-update-path/Gives the steps to create a writeable directory outside the document root and enter its absolute path in Temporary Path under Configure Update Settings on the Update WHMCS page.https://docs.whmcs.com/9-1/system/updates/update-tutorials/set-the-update-channel/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/set-the-update-channel/Gives the steps to select an Update Channel value under Configure Update Settings on the Update WHMCS page, recommending Stable for most installations.https://docs.whmcs.com/9-1/system/updates/update-tutorials/update-in-the-browser/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/update-in-the-browser/Walks through downloading and unzipping release files, renaming a customized admin directory, and running install/install.php in the browser for Full Release updates (upload, agree, backup confirmation, upgrade, delete install directory) versus the simpler Patch Set upload-and-visit-Admin-Area process.https://docs.whmcs.com/9-1/system/updates/update-tutorials/update-on-the-command-line/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/update-on-the-command-line/Gives the cp -R command to move staged release files into the installation folder and the php -f install/bin/installer.php – -u command to run the update script, plus the rm -r command to delete the install directory afterward.https://docs.whmcs.com/9-1/system/updates/update-tutorials/update-with-the-automatic-updater/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/updates/update-tutorials/update-with-the-automatic-updater/Lists the PHP requirements (128 MB memory limit, 250 MB disk space, allow_url_fopen, max_execution_time of 60+, Zip extension or proc_open, disabled open_basedir) and walks through clicking Update Now, downloading a database backup, reviewing customized files, and clicking Begin Update on the Update WHMCS page.