OpenEMR Wiki Home Page

Help needed!

OpenEMR is in need of funding for new development efforts that will benefit outpatient and inpatient users alike. Features include hybrid inpatient/outpatient support, advanced billing, Fast Healthcare Interoperability Resources (FHIR) integration, modern cloud offerings, ability to perform quality reporting, low-cost medical devices connectivity, and other commonly requested solutions. Our vibrant community is dedicated to responding to user needs and setting our priorities to be consistent with the requests of our colleagues abroad. Please consider sending a gift today.

The OpenEMR Documentation Wiki

Overview of OpenEMR

OpenEMR is a Free and Open Source electronic health records and medical practice management application. It is ONC Complete Ambulatory EHR 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?

• Frequently Asked Questions (FAQ).
• Ask at the Official OpenEMR Forums.
• Or try our IRC channel at #openemr.

Complete Ambulatory EHR Certification

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:

• EHR Incentive Program Registration and Attestation.

• 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:

• Certified List of Features That OpenEMR Successfully Passed to Obtain Certification.

• See this page for additional vital details:

• OpenEMR 4.1 ONC Complete Ambulatory EHR Certification.

• See this page if interested in how certification was achieved:

• Certification Project Archive.

• Plans for Stage II Meaningful Use Certification (due in 2014)

• Certification Stage II.

Support

• 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.

Demos

Official Demos

• OpenEMR Version 4.1.2 Demo -- This demo is the current stable release of OpenEMR.
• OpenEMR Version 4.1.1 Demo This demo is the previous stable release of OpenEMR.

Development Demos

• OpenEMR Version 4.1.3 Development Demo -- This demo is of the newest development version of OpenEMR, and may contain features known not to work yet.
• OpenEMR Version 4.1.2 Stable Demo -- This demo is of the current stable release of OpenEMR with latest patch applied (there is no sample data).
• OpenEMR Version 4.1.1 Stable Demo -- This demo is of the previous stable release of OpenEMR with latest patch applied (there is no sample data).

Downloads

• OpenEMR Downloads : Main OpenEMR download page.
• Patches : Patches for OpenEMR versions 4.1.1, 4.1.0, 4.0.0, 3.2.0, and 3.1.0 .
• Contributed Forms : A place for sharing contributed forms.
• Tools : A place for sharing contributed tools related to OpenEMR.

Installation Manuals

• OpenEMR Installation Guides.

Upgrade Manuals

• OpenEMR Upgrading Guides.

User Manuals

Main

• OpenEMR 4.1.2 User Manual (Current stable release of OpenEMR).
• 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).

Supplementary

• Backup: Lest You Rue The Day. Windows users, take note of this Forum thread.
• Billing / Practice Management

• Charges Panel.
• Credit Card Processing Inside OpenEMR.

• Clinical Decision Rules (CDR)

• CDR User Manual.
• CDR Guide: How to add Rules for Clinical Quality Measures.

• CDR User Manual.
• Using "Direct" Communication: How to use "Direct" communication in OpenEMR.
• ePrescribing: Eprescribing options.
• Facility Specific User Information.
• Forms / Encounter Notes

• Previews of Forms Distributed with OpenEMR.
• Layout Based Visit (LBV) Forms

• Customization & Layout.
• Sample Layout Based Visit (LBV) Form.
• Ophthalmology Layout Based Visit (LBV) Form: A Pictorial Guide.
• NationNotes: Medical Record Template engine with a WYSIWYG editor.

• Brief NationNotes How To
• Overview & Detailed NationNotes How To.

• Contributed Forms.

• Graphic Pain Map: Can be readily adapted to provide annotations on an uploaded image for any specialty.
• CAMOS module: An Intuitive Interface for Text Organization and Insertion in a Patient's Chart.

• Simple Note Templates.

• Importation of Data

• Import Standard Tables: An ICD9, ICD10, SNOMED and RxNorm Import Guide.
• Import RxNorm and SNOMED Tables.

• Scheduling

• Calendar Categories: How to Change Names, Colors and Intervals of Appointments.

• Search

• Find - Search HowTos: Finding Things in OpenEMR - The Various Search Methods Used.
• Patient Note and Form Searching.

• Patient Portal.
• Pharmacy Dispensary.
• Procedure Orders.
• Cross Reference of Radio Button Menu and Tree View.
• Templates for Patient Documents.
• Videos and Animations.

Configuration Manuals

General

• DIY Implementation of OpenEMR: A do-it-yourself guide with encouragements.
• Description of Settings: Documentation of the settings in Administration->Globals and Administration->Lists.
• Description of Access Controls: Documentation of the settings in Administration->ACL.
• Forms - Form Creation Tools: Tools for editing existing forms, and creating new forms in OpenEMR.
• Backup - Backup Tools: Backup Methods and Scripts in OpenEMR - Protecting Your Data.
• Database - Database Conversion Tools: Changing Data For Use in OpenEMR.
• Language Translation Configuration: OpenEMR has a thriving translation community with languages already available. If you have an interest in translating OpenEMR into your native language, please let us know.
• Multiple Sites Module: Configuration/maintenance of multiple sites from one OpenEMR instance.
• Securing OpenEMR: Advice from the community on how to secure an OpenEMR instance.
• Patient Statement Printing/Configuration Howtos.
• Layout Selection: OpenEMR now has three visual layouts to choose from. These instruction show how to configure this along with comparison screenshots.
• SSL Install Howtos.
• UTF-8 Upgrade Howto.

Modules

• 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.
• Pharmacy Dispensary Module Configuration.
• Sms/Email Notification Howtos.
• Mercury Mail Configuration in Windows XAMPP.
• CouchDB Documents Module - Using CouchDB to store patient documents.

Developer Manuals

Main

• 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.
• Architecture Overview: Overview of OpenEMR's system architecture.
• Active Projects: Listing of currently active projects.
• Typical Work Flow in a Medical Clinic: A guide for developers who need to improve their knowledge of the work flow in an ambulatory clinic
• OpenEMR API: Project in progess to auto-document OpenEMR's code.
• Code Notes: Notes on the structure of the code.

Repository

• 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.

Internationalization

• OpenEMR Internationalization Translator Guide: A HOWTO on helping with translation of OpenEMR in your native language.
• OpenEMR Internationalization Developer Guide: Developers guide to the translation engine and functions.

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.).

Development Guides

• Smarty: Using OpenEMR's embedded Smarty templating engine.
• LBV Forms: Creating Layout Based forms.
• Sample Layout Based Visit Form.
• OpenEMR Xml Form Generator : XML based forms (generates php).
• Image Based Forms: Using MI2's new image based forms interface.

Embedded Components

• ADODB: ADOdb Database Abstraction Library for PHP.
• FancyBox: hover-over iframes, used in the user interface.
• Gritter: pop-up bubbles, for notifications.
• html2pdf: OpenEMR's embedded html2pdf.
• Jquery: a javascript toolkit, that makes writing javascript easier.
• PhpGacl: OpenEMR's embedded php-GACL (access controls).
• PhpMyAdmin: OpenEMR's embedded phpMyAdmin (database administration tool).
• Open Flash Chart: Embedded javascript flash graphing for for graphing vitals other numeric data in forms.
• Smarty PostCalendar.

File Formats Used

• X12 837p Reference: A reference for the X12 billing files OpenEMR generates.

Security

• Security Alert Fixes: Track security alerts and fixes.
• Codebase Security: Assessment, plan, and tracking of project progress to globally secure the codebase.
• Securing OpenEMR: Advice from the community on how to secure an OpenEMR instance.

Release Process

• 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.

Package Development

• Appliance Developers Page: Page for Appliance development.
• Ubuntu-Debian Package Developers Page: Page for ubuntu-debian package development.
• Windows Installer.

Project Tools

• 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.

Miscellaneous

• Automated Testing: OpenEMR has an automated test suite designed to help ensure that the code does what it's supposed to and that new features do not break existing features. (note that this thing has been broken/not used for some time now).
• How to Document Code: A guide for developers to document their code properly.
• PhpXref: For those of you familiar with PhpXref, here is a parsed copy of 4.0.0. It needs more documentation.

Virtual Appliances

• Virtual Appliances Overview
• OpenEMR 4.1.1 Virtual Appliance
• Help and Tips: Variety of help and tips for the OpenEMR Appliance. Describes how to auto-start the OpenEMR-Appliance(VMware Player) in Windows.
• Appliance Developers Page: Page for Appliance development.

ISO

• ISO Overview.
• ISO Projects.

Apps

• OpenEMR Android Apps.

Troubleshooting

• 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?

• Ask at the Official OpenEMR Forums.
• Or try our IRC channel at #openemr.

FAQ Frequently Asked Questions

Not only for beginners.

• Frequently Asked Questions (FAQ).

OpenEMR Articles and Presentations

Articles

• OpenEMR on Wikipedia (Current Article).
• 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

• POSSCON Presentation (2013).

• Implementation of OpenEMR in a Paper Primary Care Office By Diane Petersen and Dr. Samuel Bowen.

• Abstract.
• Going From Paper to Electronic

• Portland Linux/Unix Group Presentation (2013).

• OpenEMR Implementation By Diane Petersen.

• Abstract.

• Libre Software Meeting (2012).

• OpenEMR, a multi-language free open source electronic health record for international use By Dr. Samuel Bowen.

• Abstract.

• 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.

• Video: http://www.openaffairs.tv/2011/06/open-emr-presentation-and-discussion-at-portland-linux-user-group/.

• POSSCON Presentation (2011).

• The Development & Growth of the OpenEMR Project By Dr Samuel Bowen and Tony McCormick.

• Video: http://www.posscon.org/presentation/development-growth-openemr-project/.
• Slides: POSSCON_OpenEMR_Growth_and_Development-v3.pdf.

• OSCON Presentation (2010).

• Taking OpenEMR, a GPL EMR to ARRA Meaningful Use Certification and beyond Presentation By Dr Samuel Bowen and Tony McCormick.

• Video: http://www.youtube.com/watch?v=zxd-ZJuiCEk.
• Slides: OpenEMR-MUCert.pdf.

• Related Blog Posts:

• Day One: http://radar.oreilly.com/2010/07/day-one-of-the-health-care-it.html.
• Day Two: http://radar.oreilly.com/2010/07/vista-scenarios-and-other-cont.html.
• Wrap Up: http://radar.oreilly.com/2010/07/wrap-up-of-the-health-care-it.html.

Ongoing Projects

• 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.

Student Projects

• Going From Paper to Electronic

Events

• Free Webinars.

• Twice monthly webinars by ZH Healthcare. See schedule.

• Conference Calls.

• Weekly conference call that is open to public and sponsored by the OEMR organization.
• Details.
• Specific call agenda/minutes.

• OpenEMR MEETUP!

• Quarterly meeting (ie. more like a social gathering) that is open to public and sponsored by the OEMR organization.
• Specific meeting agenda/minutes.

• IRC Discussions.

• Considering a weekly IRC discussion time at #openemr.

Resources

• 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.

Projects/Development

• Active Projects.
• OpenEMR Project Marketplace.
• Request for Proposals (RfP's).

Miscellaneous

• Google Summer of Code - OpenEMR is planning to submit an application for GSOC 2013.
• OpenEMR Forum Guidelines: A guide to Forum etiquette.

Organizations Supporting OpenEMR

• Sourceforge: Provides the OpenEMR project with free tools, including project management, file release repository, bug tracker, forums, and web space/server for the OpenEMR website and web tools.
• OEMR: OEMR is a 501(c)(3) organization supporting OpenEMR.

Wiki Instructions

Consult the User's Guide for information on using the wiki software.

• Configuration settings list.
• MediaWiki FAQ.
• MediaWiki release mailing list.
• Account Request and Wiki Authorship Primer - How to get an account and start a Wiki article.