OpenEMR Wiki Home Page
From OpenEMR Project Wiki
OpenEMR is in urgent need of funding for the Meaningful Use Stage III Certification. Users in the United States have reaped the bounty of the EHR Bonus in Stage I/II and will do so again in Stage III. The majority of users, outside the United States, have benefitted from Meaningful Use Certification as well in the creation of enhancements such as Electronic Prescribing, Clinical Reminders and Secure Messaging. The experience of our colleagues abroad will continue to improve with Stage III Certification. Please consider sending a gift today.
The OpenEMR Documentation Wiki
OpenEMR is a Free and Open Source electronic health records and medical practice management application. It is ONC Certified and it features fully integrated electronic health records, practice management, scheduling, electronic billing, internationalization, free support, a vibrant community, and a whole lot more. It can run on Windows, Linux, Mac OS X, and many other platforms.
- OpenEMR Features.
- OpenEMR Reviews (on Sourceforge).
- OpenEMR Articles.
- OpenEMR Success Stories.
- OpenEMR on Wikipedia.
- OpenEMR Website.
- OpenEMR Twitter Feed.
- OpenEMR Facebook Page.
- OpenEMR Google+ Page.
- Have a question to ask?
ONC Ambulatory EHR Certification
- See below sections for specific ONC Ambulatory EHR Certifications.
2011 ONC Ambulatory EHR Certification
- OpenEMR versions 4.1.0 (released on 9/23/2011), 4.1.1 (released on 8/31/2012) and 4.1.2 (released on 8/17/2013) have 2011 ONC Complete Ambulatory EHR Certification by ICSA Labs.
- This Complete EHR is 2011/2012 compliant and has been certified by an ONC-ATCB in accordance with the applicable certification criteria adopted by the Secretary of Health and Human Services. This certification does not represent an endorsement by the U.S. Department of Health and Human Services or guarantee the receipt of incentive payments.
- Information on how eligible provider should register can be found here:
- After being tested in the ICSA Labs ONC-ATCB 2011/2012 EHR Certification Program, OpenEMR 4.1 attained Complete Ambulatory EHR Certification on August 19th, 2011, satisfying the requirements for the following criteria per the ONC Approved Test Procedures v1.1:
- See this page for additional vital details:
- See this page if interested in how certification was achieved:
2014 ONC Ambulatory EHR Certification
- Developer: OEMR
- Product: OpenEMR 5.0
- Certificate Number: IG-3376-16-0042
- Certificate Date: February 13, 2017
- Criteria Certified: 170.314(a)(1), 170.314(a)(2), 170.314(a)(3), 170.314(a)(4), 170.314(a)(5), 170.314(a)(6), 170.314(a)(7), 170.314(a)(8), 170.314(a)(9), 170.314(a)(10), 170.314(a)(11), 170.314(a)(12), 170.314(a)(13), 170.314(a)(14), 170.314(a)(15), 170.314(b)(1), 170.314(b)(2), 170.314(b)(3), 170.314(b)(4), 170.314(b)(5), 170.314(b)(7), 170.314(c)(1), 170.314(c)(2), 170.314(c)(3), 170.314(d)(1), 170.314(d)(2), 170.314(d)(3), 170.314(d)(4), 170.314(d)(5), 170.314(d)(6), 170.314(d)(7), 170.314(d)(8), 170.314(d)(9), 170.314(e)(1), 170.314(e)(2), 170.314(e)(3), 170.314(f)(1), 170.314(f)(2), 170.314(f)(3), 170.314(g)(2), 170.314(g)(3), 170.314(g)(4).
- CQMs Certified: CMS69, CMS117, CMS122, CMS127, CMS138, CMS146, CMS147, CMS155, CMS165.
- Additional Software: NewCrop service version 13.05.15.03+ (for criteria 170.314(a)2 170.314(a)10 170.314(b)3), EMR Direct phiMail Server service version 1.3+ (for criteria 170.314(b)1 170.314(b)2 170.314(e)1), Z&H Healthcare Patient Portal service version 1.47+ (for criteria 170.314(e)1 170.314(e)2 170.314(e)3), Z&H Healthcare Mirth Server service version 220.127.116.1161+ (for criteria 170.314(b)1 170.314(b)2 170.314(e)1 170.314(e)2).
- This Complete EHR is 2014 Edition compliant and has been certified by an ONC-ACB in accordance with the applicable certification criteria adopted by the Secretary of Health and Human Services. This certification does not represent an endorsement by the U.S. Department of Health and Human Services.
- This is free software except for the following exceptions. There are four third party services which are required to be used with this software to fulfill Complete EHR 2014 Edition compliance; one is free and is the Z&H Patient Portal and three are not free and include the Newcrop Rx service(approximate pricing is $60 per provider per month*), the Z&H Healthcare Mirth server service(approximate pricing is $50 per month for entire practice*), and the EMR Direct phimail service(approximate pricing is $300 setup fee and $150 yearly per provider*).
- *The pricings are approximate and depend on the vendor. OEMR will provide list of vendors whom offer these third party services upon request.
- There are no contractual or technical limitations.
- Certification Document(s):
- Certified Versions:
- OpenEMR 5.0.0 (released 2/15/2017)
- See below for the work it took to obtain 2014 ONC Ambulatory Complete EHR Certification:
- OpenEMR version 4.2.0 (released 12/28/2014), 4.2.1 (released 03/25/2016), and 4.2.2 (released 05/19/2016) have 2014 ONC Modular Ambulatory EHR Certification by InfoGard Laboratories.
- This EHR Module is 2014 Edition compliant and has been certified by an ONC-ACB in accordance with the applicable certification criteria adopted by the Secretary of Health and Human Services. This certification does not represent an endorsement by the U.S. Department of Health and Human Services or guarantee the receipt of incentive payments. This is free software and does not have any additional costs associated with it that related to it use as provided by this project site. There are no limitations.
- Certification Documents:
- ONC site link:
2015 ONC Ambulatory EHR Certification
- Currently in the planning stages.
- Ongoing work for 2015 ONC Ambulatory Complete EHR Certification:
- OpenEMR Support Guide: Guide for users on how to take the most advantage of free and professional support for OpenEMR.
- Professional Support: The OpenEMR project has a large number of vendors and individuals who offer their services supporting, installing, hosting and customizing OpenEMR.
- DIY Implementation of OpenEMR: A do-it-yourself guide with encouragements.
- OpenEMR Version 5.0.0 Demo -- This demo is the current stable release of OpenEMR.
- OpenEMR Version 4.2.2 Demo This demo is of a prior stable release of OpenEMR.
- OpenEMR Version 4.2.1 Demo This demo is of a prior stable release of OpenEMR.
- OpenEMR Version 4.2.0 Demo This demo is of a prior stable release of OpenEMR.
- OpenEMR Version 4.1.2 Demo This demo is of a prior stable release of OpenEMR.
- OpenEMR Version 5.0.1 Development Demo -- This demo is of the newest development version of OpenEMR, and may contain features known not to work yet. The "Up For Grab" demos can also be found here.
- OpenEMR Version 5.0.0 Development Demo -- This demo is of the current stable release of OpenEMR with latest patch applied (there is no sample data)
- OpenEMR Version 4.2.2 Development Demo -- This demo is of a prior stable release of OpenEMR with latest patch applied (there is no sample data).
- OpenEMR Version 4.2.1 Development Demo -- This demo is of a prior stable release of OpenEMR with latest patch applied (there is no sample data).
- OpenEMR Version 4.2.0 Development Demo -- This demo is of a prior stable release of OpenEMR with latest patch applied (there is no sample data).
- OpenEMR 5.0.0 User Manual (Current stable release of OpenEMR).
- OpenEMR 4.2.2 User Manual.
- OpenEMR 4.2.1 User Manual.
- OpenEMR 4.2.0 User Manual.
- OpenEMR 4.1.2 User Manual.
- OpenEMR 4.1.1 User Manual.
- OpenEMR 4.1.0 User Manual.
- OpenEMR 4.0 User Manual.
- OpenEMR 3.2 Users Manual (PDF).
- OpenEMR 3.1 Users Manual (PDF).
- OpenEMR 3.0 Users Manual (PDF).
- Lest you rue the day.
- Take note of this Forum thread.
- System Image: Creation and recovery in 32/64 bit devices.
- Clinical Decision Rules
- Data Import
- Diagnostic Studies
- Step wise explanation of how to configure Procedures:
- Diagnostic Laboratories Orders.
- Laboratory Catalogue Configuration.
- Laboratory Orders & Results.
- Procedures Module Configuration for Manual Result Entry: A pictorial guide.
- Laboratory Exchange User Documentation: Communication with external laboratory facility.
- Step wise explanation of how to configure Procedures:
- Efficiency Tools
- Contributed Forms: 60 forms.
- Layout Based Visit Forms.
- Nation Notes: LBV Form with a WYSIWYG editor.
- Meaningful Use
- Practice Setup
- Description of Access Controls: Documentation of the settings in Administration->ACL.
- ACL Fine Granular Control: A guide with examples and screenshots.
- Client Sided Validation
- HOWTO: Create And Use Database Views.
- Backup - Backup Tools: Backup Methods and Scripts in OpenEMR - Protecting Your Data.
- Database - Database Conversion Tools: Changing Data For Use in OpenEMR.
- OpenEMR Deletion.
- Forms - Form Creation Tools: Tools for editing existing forms and creating new forms in OpenEMR.
- DIY Implementation of OpenEMR: A do-it-yourself guide with encouragements.
- Installation in a hosted environment.
- Layout Selection: Configuration and selection of three visual layouts with comparison screenshots.
- Language Translation Configuration: Translation of OpenEMR into your native language.
- Multiple Sites Module: Configuration and maintenance of multiple sites from one OpenEMR instance.
- Operating Systems.
- Securing OpenEMR: Advice from the community on how to secure an OpenEMR instance.
- Description of Settings: Documentation of the settings in Administration->Globals and Administration->Lists.
- Patient Statement Printing/Configuration Howtos.
- SSL Install Howtos.
- UTF-8 Upgrade Howto: Configuration of non-Latin scripts.
- Windows Package Dual Upgrade: Simultaneous upgrades of XAMPP and OpenEMR.
- Billing - Billing Setup Howtos: How To Configure and Use OpenEMR For Billing.
- Calendar - Using The Calendar As A Tool: Using The Calendar As A Tool in OpenEMR.
- CouchDB Documents Module - Using CouchDB to store patient documents.
- Mercury Mail Configuration in Windows XAMPP.
- Pharmacy Dispensary Module Configuration.
- Sms/Email Notification Howtos.
- Z&H's CCDA Module: Setup and Configuration of Z&H's Carecoordination module.
- Information For New Developers: If you are a developer looking to contribute to the project, check this page for details on how to get started.
- Policies for Developers: Agreed upon policies developers must observe (or provide a good reason not to).
- How to Document Code: A guide for developers to document their code properly.
- Active Projects & Projects Needing Developers: Listing of projects, both Active & Proposed.
- Active Independent Developers / Contributors: Listing of volunteer and independent freelance developers working on OpenEMR.
- OpenEMR API: Project in progess to auto-document OpenEMR's code.
- OpenEMR Project Marketplace.
- Request for Proposals (RfP's).
- Our git Repository structure, work flow, and developer roles: This describes our current git repository structure, work flow, and current developer/contributor roles.
- git For Dummies: This is a quick, practical OpenEMR walk through with the goal of getting new developers up and working with git as quick as possible.
- Using Git with OpenEMR: Example workflow for preparing patches for OpenEMR with Git.
- Git Migration: Documentation of the migration from the cvs repository to the git repository, which was completed on 10/30/2010.
Modules and Modular Interfaces
- CDR Engine: stuff related to the Clinical Decision Rules engine.
- Background Service Manager
- The OpenEMR API: Core interfaces for OpenEMR programming.
- The Forms API: an interface for adding additional encounter and non-encounter based forms.
- The Notes API: an interface for adding and managing non-medical notes attached to a patient's file.
- The Reminders API: an interface for adding and managing reminders.
- Lists and Layouts: built-in List editing, and simple form layout editor.
- Sending Email: Preferred mechanism of sending email(s).
- Prescribing Module: Walk-through of the prescribing module.
- Code Types: Explains the current scheme for containing code types (such as ICD9, CPT) etc.
- Diagnostic Codes Development: Current plan/implementation for diagnostic code sets (ICD9,ICD10,SNOMED, etc.).
- ADODB: ADOdb Database Abstraction Library for PHP.
- Bower: Mechanism to attempt to standardize assets that are used by OpenEMR.
- Composer: Mechanism to standardize php libraries that are used by OpenEMR.
- FancyBox: hover-over iframes, used in the user interface.
- Gritter: pop-up bubbles, for notifications.
- html2pdf: OpenEMR's embedded html2pdf.
- PDF: pdf libraries/packages in OpenEMR
- PhpGacl: OpenEMR's embedded php-GACL (access controls).
- PhpMyAdmin: OpenEMR's embedded phpMyAdmin (database administration tool). (requires PHP 5.5+)
- Postnuke Calendar.
- Zend (requires PHP 5.3.3+)
File Formats Used
- X12 837p Reference: A reference for the X12 billing files OpenEMR generates.
- Upgrade Mechanism: How upgrades are done.
- Patch Mechanism: How patches are done.
- Steps for a patch release: Documented steps for a patch release.
- Steps for an official release: Documented the steps for an official full release.
- OpenEMR Acknowledgments: Contributors (testers, bug fixers, developers, translators, etc.) can enter their information here if they want to by included in the Acknowledgments Notice.
- New Features in Each Release: New features in each release (starting from version 4.0).
- Status of an ongoing new release process: Listing of active bugs and planned features with status for an ongoing release.
- OpenEMR Website: OpenEMR website description and development.
- OpenEMR Wiki: OpenEMR wiki description and development.
- OpenEMR Forum: OpenEMR forum description and development.
- OpenEMR IRC: OpenEMR IRC chat channel description.
- OpenEMR Twitter Feed: OpenEMR twitter feed description.
- OpenEMR Facebook Page: OpenEMR Facebook page.
- OpenEMR Google+ Page: OpenEMR Google+ page.
- OpenEMR Diaspora Page: OpenEMR Diaspora Page.
- OpenEMR Community Demo Development: Description for setting up the community demo.
- OpenEMR Slack Chat: OpenEMR Slack Chat description.
- General Troubleshooting -- general problems people have experienced with OpenEMR, and (hopefully) their solutions.
- Common Installation Problems -- problems people have experienced installing OpenEMR, and (hopefully) their solutions.
- Take advantage of the free community support. If you have a question to ask?
FAQ Frequently Asked Questions
- Not only for beginners.
OpenEMR Articles and Presentations
- OpenEMR on Wikipedia (Current Article).
- New Technology Makes EMRs Easier, Searchable, More Secure (February, 2017)
- 7 cool little open source projects that stood out in 2016 (December, 2016)
- Open Source Health Announces openEMR Collaboration with more then 50,000 annual downloads to Clinics in 200 Countries (December, 2014).
- The Growing 'OpenEMR' Business Community (November, 2013).
- U.S. Peace Corps Adopts OpenEMR for use in 77 Countries World-wide (November, 2013).
- Peace Corps OpenEMR Project Starts (November, 2013).
- EnSoftek, Inc. Wins Peace Corps Global Electronic Medical Records (EMR) System Development and Implementation Contract (November, 2013).
- Bossie Awards 2013: The best open source applications (September, 2013).
- EMR Direct Announces Availability of Direct Project Secure Email Powered by phiMail™ in OpenEMR 4.1.2 (August, 2013).
- OpenEMR v.4.1.2 - Planned Release (July, 2013).
- OpenEMR & Ophthalmologist's Meaningful Use Attestation (April, 2013).
- ZH Healthcare Offers the Next Step in OpenEMR Patient Portal with Progressive New Features (January, 2013).
- OpenEMR Continues to grow in Popularity and Use (December, 2012).
- OpenEMR presented to the Kenya Medical Association (December, 2012).
- Key health IT systems moving into the final phase of the Open Source Maturity Model (December, 2012).
- Going From Paper to Electronic: A Road Map (December, 2012).
- Vendor launches on-line OpenEMR education program (December, 2012).
- Open Source EMR Alternatives for Kenya (November, 2012).
- OpenEMR continues to make news (October, 2012).
- 10 award-winning open source apps to try today (September, 2012).
- Bossie Awards 2012: The best open source applications (September, 2012).
- HP India Mobile Health Centre Project To Utilize OpenEMR (July, 2012).
- Siaya District Hospital in Kenya Goes Live With OpenEMR (April, 2012).
- OpenEMR continues to flourish (March, 2012).
- MediGrail LLC Automates Siaya District Hospital in Rural Kenya with OpenEMR (February, 2012).
- Peace Corps plans EHR system in 2013 (February, 2012): OpenEMR to be used by the Peace Corps.
- DIY: OpenEMR, free software for medical practices (October, 2011).
- OpenEMR 4.1 Achieves Full 'Meaningful Use' Certification (August, 2011).
- Taking medical records into the digital age - Solving traditional system challenges with OpenEMR (2010).
- OpenEMR - At a glance (2010).
- FPAI conducts training on OpenEMR (2010).
- OpenEMR Success Story (2009).
- Guest Article: Open Source EMRs for free clinics (2009).
- Open Source Electronic Health Records: In Public Policy. (2009).
- Open Source Electronic Health Records: in Practice. (2009).
- Open Source EMR and Practice Management Software Appliance (2007).
- Using OpenEMR in Family Practice (2006).
- Technical Aspects of OpenEMR. Julia Weatherby (2006).
- OpenEMR Architecture. T. Simbini (2006).
- The OpenEMR Community. Margaret Donahue (2006).
Videos and Presentations
- Linux Action Show (2017).
- "Taking Linux to Heart": Discussion of a OpenEMR use case in a cardiology practice.
- Starts at 30:55 in the following video:
- POSSCON Presentation (2013).
- Implementation of OpenEMR in a Paper Primary Care Office By Diane Petersen and Dr. Samuel Bowen.
- Portland Linux/Unix Group Presentation (2013).
- OpenEMR Implementation By Diane Petersen.
- Libre Software Meeting (2012).
- OpenEMR, a multi-language free open source electronic health record for international use By Dr. Samuel Bowen.
- Ohio LinuxFest Presentation (2011).
- Taking OpenEMR to Meaningful Use Certification and Beyond By Dr Samuel Bowen.
- Slides: Ohio_Linuxfest_OEMR-2011-09-09.pdf.
- Portland Linux/Unix Group Presentation (2011).
- Introduction to OpenEMR By Tony McCormick.
- POSSCON Presentation (2011).
- The Development & Growth of the OpenEMR Project By Dr Samuel Bowen and Tony McCormick.
- OSCON Presentation (2010).
- Taking OpenEMR, a GPL EMR to ARRA Meaningful Use Certification and beyond Presentation By Dr Samuel Bowen and Tony McCormick.
- Related Blog Posts:
- General Marketing of OpenEMR: General articles describing the OpenEMR project and discussing features of OpenEMR.
- Open Source EMRs are Better: Articles to convince users why open source emrs are better than proprietary emrs by 1) defining open source software, 2) describing why open source EMR's are better than proprietary EMR's, 3) describing how to find a vendor/support and 4) showing examples of OpenEMR working in practices.
- Success Stories: Clinic success stories are here.
- Conference Calls.
- Twice weekly conference call that is open to public.
- Once monthly OEMR board meeting that is open to the public.
- IRC Discussions.
- Considering a weekly IRC discussion time at #openemr.
- Health Information and the Law a project of the George Washington University’s Hirsh Health Law and Policy Program, developed with support from the Robert Wood Johnson Foundation, is designed to serve as a practical online resource to federal and state laws governing access, use, release, and publication of health information.
Organizations Supporting OpenEMR
- Consult the User's Guide for information on using the wiki software.