Updating EasyChat
The Update Center checks for a new EasyChat version and selects the safe installation method for your platform. Open Update in the administrator sidebar.
The header, refresh action, and content cards share one responsive grid with comfortable spacing on desktop, tablet, and mobile screens.
Automatic Checks
Before changing any files, EasyChat checks:
- the official release signature;
- the package size and checksum;
- embedded updater compatibility;
- the platform and its exact package;
- required server capabilities;
- write access and free disk space for Generic PHP.
Installation does not start when a required check fails. A technical failure never replaces the currently working version.
Platform-Specific Updates
Generic PHP provides an Install update button. EasyChat creates a protected backup before publishing verified files. If the new version cannot be fully verified, the previous files are restored automatically.
After confirmation, the screen shows four clear phases: verification, download, preparation, and installation. If the browser loses its connection or the page is reloaded, EasyChat reconciles the saved phase and continues the same operation. It never starts another installation on top of one already in progress. EasyChat retries a temporary failure first and shows Retry phase only when operator input is actually needed.
If EasyChat has already been updated in another tab or by a manual deployment, the Update Center closes the earlier operation automatically. Its old error and Retry phase action disappear without reinstalling the older archive.
Before replacing files, EasyChat waits up to 70 seconds for active requests to
finish. If it cannot proceed, the message explains how to retry and check
long-running jobs or permissions on the log directory. There is no need to
delete lock files manually.
Preparation files are kept outside the running EasyChat directory. This keeps the updater from trying to publish a source tree over itself even when the hosting log directory lives inside the installed runtime.
On Windows, EasyChat follows the platform’s access model instead of reporting a false failure for unavailable POSIX permission bits. When an earlier request is still finishing, the installer briefly waits for the files to be released instead of failing immediately.
The first transition from an older installation to protected updates may need up to four minutes once while previous server requests finish. Update Center shows an exact countdown and resumes automatically. Later updates wait for actual active requests only and usually start much faster. Keeping the tab open is still preferable, but a page reload no longer loses the saved operation.
EasyChat pauses background admin checks during this countdown so they cannot create new requests before files are replaced. Polling resumes automatically after installation, an error, or navigation away from the page. A legacy lock file is hardened in place only after EasyChat confirms that it is a regular, unused file and has not been replaced with a link.
When a One-Time Transition Is Required
Some Generic releases earlier than 1.12.0 cannot safely replace their own updater. EasyChat therefore does not keep retrying a phase that cannot succeed. Update Center shows Download transition package instead.
- Download the package from that button or the official download page only.
- Extract the
easychatdirectory over the existing installation directory. - Do not delete the existing directory first, and do not replace its
config.php,log, oruploadsdata with empty directories. - Open Update Center again and select Check.
Settings, conversations, uploads, and logs remain in place. Any interrupted operation is reconciled with the installed version and cannot publish its old prepared files. Later Generic updates return to the regular one-click flow.
Before You Continue
- keep the tab open where practical until EasyChat or the CMS reports completion;
- do not start two installations at the same time;
- do not unpack an unknown archive over a live installation;
- follow the CMS recommendation when it asks for a site backup.
After the update, open conversations, send a test message from the widget and check connected channels. Generic PHP keeps settings, conversation data, uploads and logs outside the replaced release file set.
If installation does not complete, the current version remains operational.
Record the attempt time before contacting support: safe update stages are kept
in the local log/update.log file without passwords or API keys.