LibreHealth EHR - Free Open Source Electronic Health Records
robbyoconnor Remove default site volume mount
This was done for ease of use...but for production -- we do not want this.
Latest commit 81733f3 Dec 13, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Documentation Add Lost Pluging Doc back (#978) Feb 1, 2018
Tests Liberation (#33) Aug 4, 2016
assets The User activity report reports user activity by pulling data from t… ( Oct 20, 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
docker Some minor fixes Dec 13, 2018
gacl PHP 7.1 Updates (#992) Mar 16, 2018
images The User activity report reports user activity by pulling data from t… ( Oct 20, 2018
interface Medical Issue End-date display (#1345) Dec 10, 2018
library removed un-used calendar files (#1320) Dec 4, 2018
modules 2019 ICD10 Code upload #1231 (#1258) Oct 31, 2018
patient_portal Update for patient id generator function (#1079) Mar 23, 2018
sites/default The User activity report reports user activity by pulling data from t… ( Oct 20, 2018
sql removed un-used calendar files (#1320) Dec 4, 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
.dockerignore Some more docker refactoring Oct 31, 2018
.gitignore Some more docker refactoring Oct 31, 2018
.gitlab-ci.yml Some more docker refactoring Oct 31, 2018
CONTRIBUTE.md 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
Dockerfile Update READMEs and bump the PHP Version to 7.2 Oct 31, 2018
INSTALL.md 3 changes report preparing generator Apr 30, 2018
README.md Update READMEs and bump the PHP Version to 7.2 Oct 31, 2018
WINDOWS_INSTALL.md Added WINDOWS_INSTALL.md Separate of INSTALL.md (#1289) Nov 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
docker-compose.prod.yml Remove default site volume mount Dec 14, 2018
docker-compose.yml Some minor fixes Dec 13, 2018
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

README.md

LibreHealth EHR

pipeline status

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.

Docker Support

Docker images are now pushed to GitLab's container registry built using GitLab CI.

Currently the image uses PHP 7.2 and Apache. We plan to support more than one version of PHP, which will be published at a later date.

For the database in the docker-compose files, we use MariaDB

See the Docker README for more information.

Installation

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:
    sql-mode = STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
    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, https://github.com/your-github-username/LibreEHR
  • 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.

License

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!