Skip to content


Repository files navigation

FEMR - Fast Electronic Medical Records

Build Status

Scala CI


fEMR is a fast EMR solution for remote clinics who depend on speed and ease of use rather than complex features. Check out Team fEMR's website for more information and a live demo.


  1. Slack
  2. JIRA
  3. Team FEMR



For more information on contributing, please see the file. For details regarding installation and deployment, continue reading.


This repo uses Github Actions workflows for continuous integration, which can be found under the Actions tab in Github ( The Scala CI workflow runs 'sbt test' whenever code is pushed or a pull request is made to the main branch.

Setting up weekly backup reminder

  • It is very important for the administrator to backup local data to the remote database.
  • A cronjob can be set up before a kit is deployed to automatically display a message once a week.
  1. In the command line, type crontab -e
  2. A text editor should appear.
  3. Add the following line to this file: 0 11 * * 5 /util/
  4. This will display a reminder pop up at 11:00AM every Friday.


  • fEMR is not HIPAA compliant (... yet).
  • fEMR is not meant to diagnose, treat, cure or prevent disease.
  • fEMR may attempt to establish a secure remote connection when internet access becomes available. This behavior is configurable and turned off by default.



Running the application using Docker

  1. Make sure you have Docker installed and running on your machine.
  2. Clone the FEMR/femr repo: git clone
  3. Checkout the super-femr branch: git checkout super-femr.
  4. Cd into the femr directory: cd femr
  5. Run docker-compose up to start the app.
  6. If step 5 successfully finishes, then the app will be available at http://localhost:9000/

Setting up the project with IntelliJ on macOS

Step 1: Download and Install the following Software and Dependencies

Step 2: Clone the repo and checkout super-femr branch

  • git clone
  • git checkout super-femr

Step 3: Setting up the DB

  1. Open the MySQL Workbench.
  2. Select the db icon to create a new schema and call it femr_db.


  1. Under the Administration tab, select User and Priviliges. Then Add account and add Login name and Password of your preference. Save the login and password because you will need it in the later steps.
    • For this example, the username is testing and password is password.


  1. Then go to the Schema Privileges tab, select Add Entry... for the user you created in the previous step, and select the femr_db schema.



  1. Give all of the rights, except the GRANT OPTION.


Step 4: Configuring IntelliJ

  1. Open IntelliJ IDEA Ultimate. Then open the femr project with super-femr branch checked out.

  2. In IntelliJ IDEA Ultimate and go to Preferences -> Plugins -> click Marketplace -> Then download Scala and Play Framework. Then restart the IDE.

  3. Inside femr/conf folder, create a new file named

  4. Copy the following settings inside and save it. Note that db.default.username and db.default.password values must match the account and password from the Step 3.3. For this example, my username is testing and password is password.

include "application.conf"
  1. Go to Run -> Edit Configurations -> click on the + sign -> Play 2 App.


  1. Then, click on Edit Environment Variables -> add the following two environment variables: user.dir and config.file (make sure to change the value based on where the two are stored on your local machine). Then click apply and ok.
    • config.file is the path for
    • user.dir is the path for the project.


  1. Go to File -> Project structure -> Under the Project tab -> Select Project SDK and set it to 1.8.
    • You can download 1.8 directly from IntelliJ. If so, choose 1.8 Amazon Correto.


  1. Change the language level to 8.


  1. On the rightmost side of IntelliJ, if there is a vertical line containing sbt. Click on the sbt tab and then click the refresh symbol.
    • If there isn’t sbt on the right, remove the .idea folder from the root directory of the project. In the command line, traverse to the root directory and do: rm -r .idea. Then redo step 2 and then continue. If still does not work try removing the project and recloning it again.


  1. After that runs, click on the Play button to run the configuration. If everything was set up correctly, the website should open up on another window. Select “Apply this script now”.



  1. Try deleting the .idea folder and rerunning sbt
  2. Confirm you have the absolute path in your environment variables
  3. Try to re-apply the plugins Scala and Play Framework
  4. Otherwise, try cloning the femr github and going through the steps once more.
  5. Try invalidating Intellij IDEA cache.