OpenEMR Windows Upgrade
From OpenEMR Project Wiki
XAMPP cannot run OpenEMR 8.3.0 or later. OpenEMR 8.3.0+ requires PHP 8.3+ and MariaDB 10.6+; the last XAMPP for Windows release (8.2.12, November 2023) ships PHP 8.2 and MariaDB 10.4. The supported way to run current OpenEMR is the official Docker image.
- New install: use the official OpenEMR Docker image (Docker Desktop on Windows 10/11, or a Linux VM). A production compose file is in openemr/openemr.
- Already on XAMPP: follow the XAMPP to Docker Migration guide.
The manual instructions below are kept for reference and for versions before 8.3.0.
Notes
- Need to ensure the downloaded zip file has been unblocked after downloading.
Upgrade
- (note example below is for upgrading to 8.2.0; swap with version that you are installing)
- Move current /openemr directory to a backup directory openemr_bk
- Unpackage 8.2.0 openemr into web directory and rename the directory to openemr
- Copy following directory from old version to /openemr directory:
- openemr_bk/sites/default/documents (COPY TO) => openemr/sites/default/documents
- Copy the openemr/sites/default/sqlconf.php file from your old version into the new openemr version
- In the openemr/sites/default/sqlconf.php file, set the $config variable (found near bottom of file within bunch of slashes) to 1 ($config = 1;)
- Open openemr/sql_upgrade.php (http://localhost/openemr/sql_upgrade.php) in web browser, choose your old version and click 'Upgrade Database'
- Configure optional settings in openemr/sites/default/config.php files
ONC Ambulatory EHR Certification Requirements
Securing OpenEMR
- See the Securing OpenEMR Guide
