VMWare Player Download and Installation Instructions


If you are having issues with the 6 step download process enumerated here, please refer to our detailed trouble-shooting guide.

Step 1:

Download and Install VMWare Player v3.0 To download VMWare player for free, you will need to sign up for an account via a form.


Step 2:

Next, download the popHealth v1.1.3 Virtual Machine and save the file someplace on your computer, such as your Desktop, or in a another directory where you will want to use popHealth. You should unzip this file, and you will now have an uncompressed virtual machine "popHealth.vmwarevm". This file will allow you to launch a popHealth server, data importer and C32/CCR analysis tools on your computer.


Step 3:

After you have installed VMWare Player, and downloaded the popHealth virtual machine, double-click on the popHealth machine image to startup your own popHealth virtual machine. After the VM starts, you should see an image of a virtual machine running with a purple desktop background. This is the popHealth virtual machine, that has been pre-configured with all of the software dependancies necessary to run popHealth.


Step 4:

Next, export your patient records via the HITPS C32 format, or ASTM CCR format from your Electronic Health Record system. You should include all your C32 or CCR records in a single folder. Drag this folder into your popHealth desktop. If you don't have any C32 or CCR files, and would still like to user popHealth with randomized patient data, refer to our instructions for seeding the system with random data under the "Test Patient Records" section of our Wiki here.


Step 5:

Import your patient records into popHealth. To do this, start up the popHealth Data Importer tool by double clicking on the "popHealth C32/CCR Importer" icon on the desktop. Once the popHealth Data Importer tool starts up, you should select a directory from the file menu where all of your C32 or CCR XML files have been exported by going to the menu bar and selecting File:Open. Once you have selected the directory directory with your records, all of the files in that directory will be analyzed and displayed in the popHealth Data Importer tool. You can now select the "Import" button on the bottom of the user interface. Each C32 or CCR record in the directory you have selected will be uploaded to the popHealth database via a secure RESTful service on the popHealth web application.


Step 6:

Double click on the popHealth Web Application desktop icon. This will bring up the popHealth report user interface via the FireFox browser. If you have already created a popHealth account, you should enter your credentials now. If you have not created a popHealth account, you should create a new account via the form available via the "Create New Account" link on the login page.

Congratulations! You are now using the popHealth application, and can select measures via the list of Meaningful Use Clinical Quality Measures on the left side of the popHealth interface.


* For users wanting to set up popHealth on a non-Windows system using the popHealth virtual machine, you will need to consider alternative VM hosting applications such as VMWare Fusion for the Apple platform, or Virtual Box.

** For users wanting to set up popHealth as a dedicated server, refer to the detailed, step-by-step instructions from the popHealth wiki page available here. Setting up a dedicated popHealth server will require users are comfortable with server administration tasks, such as installing MongoDB, Ruby on Rails, Redis, and other software dependancies, sometimes from source code.


Documents in PDF format require the Adobe Acrobat ReaderĀ®.
If you experience problems with PDF documents, please download the latest version of the ReaderĀ®.


Windows 7 Installation Instructions


The popHealth Windows 7 follows the steps in the installation instructions for the associated binary installers below:
Windows7 32 Bit Installer
Windows7 64 Bit Installer