LibreHealth EHR - Free Open Source Electronic Health Records
Failed to load latest commit information.
Documentation Add Lost Pluging Doc back (#978) Feb 1, 2018
Tests Liberation (#33) Aug 4, 2016
assets Izi Modal Refactoring Apr 30, 2018
ccdaservice Newest version of portal. (#957) Jan 26, 2018
ccr fix for issue reported in GCI (#1046) Mar 6, 2018
controllers Some general cleanup (#714) Oct 12, 2017
custom /custom directory cleanup. (#1130) May 23, 2018
gacl PHP 7.1 Updates (#992) Mar 16, 2018
images Notification message Apr 17, 2018
interface added migration to add an index to pid col of tf_patient_tags pivot t… Sep 5, 2018
library [GSoC 2018] LIMS Integration into EHR (#1204) Aug 28, 2018
modules fixed broken link in calendar search results (#1238) Sep 6, 2018
patient_portal Update for patient id generator function (#1079) Mar 23, 2018
sites/default [GSoC 2018] LIMS Integration into EHR (#1204) Aug 28, 2018
sql [GSoC 2018] LIMS Integration into EHR (#1204) Aug 28, 2018
templates added the 2 missing echos (#1193) Jun 23, 2018
updater fix for folders with dot causing bug in updater (#1208) Sep 4, 2018 How to contribute to github (#1108) May 15, 2018
COPYRIGHT_AND_LICENSE.txt Rename COPYRIGHT_AND_LICENSE to COPYRIGHT_AND_LICENSE.txt Sep 14, 2016 3 changes report preparing generator Apr 30, 2018 minor-readme-update (#1033) Mar 23, 2018
acknowledge_license_cert.html Fix Bowen medical URL (#756) Nov 15, 2017
acl_setup.php Replacement for original mips PR (#701) Oct 10, 2017
acl_upgrade.php Turn NationNotes into a module (#465) Mar 6, 2017
composer.json Some general cleanup (#714) Oct 12, 2017
composer.lock Issue 120 appt hooks (#123) Aug 25, 2016
controller.php PHP7 Project. Commit 12. Converted some split() calls to explode() an… Jan 30, 2016
favicon.ico Documentation and installer helpers (#454) Mar 6, 2017
gpl_license.txt Update Licenses and Add PLugin FAQ Sep 14, 2016
index.php Setup legacy remove and upgrade (#1128) May 22, 2018
mpl_license.txt Update Licenses and Add PLugin FAQ Sep 14, 2016
phpunit.xml Liberation (#33) Aug 4, 2016
portal_version.php Add version to portal (#1054) Mar 6, 2018
setup.php Setup legacy remove and upgrade (#1128) May 22, 2018
sql_patch.php Favicon.ico 404 errors (#1151) Jun 13, 2018
sql_upgrade.php Favicon.ico 404 errors (#1151) Jun 13, 2018
version.php Clean up the code for the next set of changes (#1142) Jun 2, 2018

LibreHealth EHR

LibreHealth EHR is a free and open-source electronic health records and medical practice management application.

The mission of LibreHealth is to help provide high quality medical care to all people, regardless of race, socioeconomic status, or geographic location, by providing medical practices and clinics across the globe access to free of charge medical software. That same software is designed to save clinics both time and money, which gives practitioners more time to spend with individual patients, thereby supplying patients with higher quality care.

We are current and former contributors to OpenEMR and thank that community for years of hard work. We intend to honor that legacy by allowing this new community to leverage the good things in OpenEMR, share what we create and not be afraid to break backward compatibility in the name of forward progress and modern development models.

We are collaborating closely with the LibreHealth Project, an umbrella organization for health IT projects with similar goals.

Contributing code

Code contributions are very welcome! We encourage newcomers to browse the issue tracker for open issues and/or if you have found a bug in LibreEHR, please create a new issue for same. You may open a pull request to contribute your code to an issue, from your fork of the LibreEHR repository.


For detailed, step-by-step instructions, refer to Installation Instructions

On Windows:

  1. First off, make sure that you have the WAMP or XAMPP server installed and that the time zone is set correctly.

  2. Make the following changes in php.ini file. You can find the php.ini file by looking at the following destination: ..* In the case of WAMP : C:/WAMP/BIN/PHP/php.ini OR (left click) wampmanager icon -> PHP -> php.ini ..* In the case of XAMPP: C:\xampp\php\php.ini.. In Linux, it is located in: /etc/php/7.0/php.ini or something similar.

Make the following changes in your php.ini file: (Search for the following and make necessary changes)

max_execution_time = 600
max_input_time = 600
max_input_vars = 3000
memory_limit = 512M
post_max_size = 32M
upload_max_filesize = 32M
session.gc_maxlifetime = 14400
short_open_tag = On
display_errors = Off
upload_tmp_dir is set to a correct default value that will work on your system
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE
  1. Make sure you have disabled strict mode in Mysql.

How to disable Mysql strict mode?

Make the following changes in the my.ini/my.cnf: Find it here C:\WAMP\BIN\MYSQL\MySQL Server 5.6\my.ini OR C:\xampp\mysql\bin\my.ini OR (left click ) wampmanager icon -> MYSQL -> my.ini In Linux it's typically located in /etc/mysql

1.  Look for the following line:
    or sometimes it maybe sql_mode

2.  Change it to:
    sql-mode="" (Blank)

3. Restart the MySQL service.
  1. Restart WAMPP/XAMPP Server.

(XAMPP) If you don't find this parameter (sql-mode/sql_mode) in the my.ini file, you should run the server, open http://localhost/phpmyadmin/, click on the "variables" tab, search for "sql mode", and then set it to: ""

  1. You can fork & clone the repository for local development. To get started you need to:
  • Fork the LibreEHR repository.
  • Clone your fork of LibreEHR repository to your local machine. Your fork would be on, as an example,
  • Open LibreEHR directory and run index.php file, which will then redirect to the setup page! Follow the instructions and you are done!

Note: Sometimes , installation may take more time than usual on some systems. In that case, you would need to increase max_execution_time in your php.ini file and then restart your server.


LibreHealth EHR is primarily licensed under Mozilla Public License Version 2. The code inherited from OpenEMR is licensed under GPL 2 or higher. This project is a part of the Software Freedom Conservancy family.

Thank you for your support!