masslight/ottehr
masslight/ottehr has 346 GitHub stars and 391 forks. GitHot measured -1 stars in 24 hours. Last checked 2026-11-21 16:39 UTC. Last push 2026-11-19.
Measured star growth
- in 24h
- -1
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Modular, Production-Ready, Open-Source EHR
Web & AppsREADME.md
Original
The production-ready, open-source EHR
Ottehr
Ottehr is a modern, modular EHR. Ottehr uses the headless EHR Oystehr as a service provider and to host its backend service endpoints. Ottehr requires a free Oystehr account to run as-is. Ottehr is designed for developers, making it easy to fork, white-label, and build entire new classes of EHRs and health-tech products with a fraction of the effort of starting from scratch.
Ottehr consists of three components:
- Ottehr Patient Portal — A patient-facing registration website for creating appointments and initiating telemedicine calls, with features including rescheduling, check-in, intake chatbot and paperwork, text messages and emails, and listing appointments for an account.
- Ottehr EHR — A staff-facing EHR for managing appointments and completing encounters, with features including checking appointments, managing patient queues, texting patients, updating a location's slots, setting a location's schedule, joining telemedicine calls, HPI and medical history, exam charting, eRx and assessment, patient plan, RCM and claims submission, and more.
- Ottehr Backend — The backend for the Patient Portal and EHR apps, it is composed of Function-as-a-Service endpoints deployed as Oystehr Zambdas.
Run Ottehr Locally
AI-prompt setup
You can use an LLM to help you get up and running with Ottehr for the first time. First, install Node.js 22 and Terraform 1.16.
Clone the repository, start up Claude Code or similar at the root of the repository, and use a prompt like the one below and replacing the placeholders,
I just cloned Ottehr, the open source EHR. I want to get up and running locally so I can kick the tires to check it out. In order to do this I know we'll need these three things: My PROJECT_ID is <PROJECT_ID>, and my M2M Client credentials are Client=<CLIENT_ID>, Secret=<SECRET_KEY>. Use the local terraform backend.
Prerequisites
To run Ottehr, you'll need a free Oystehr account and Node.js.
Get Your Oystehr Account
- Visit oystehr.com.
- Click on Free Access to initiate your early access request.
Once your request is received, the Oystehr team will promptly create your account and reach out to you via email.
Check out the Oystehr Technical Documentation to learn more about the Oystehr platform.
Install Node.js 22.13 or newer
If you do not already have it, install Node.js v22.13 or newer on the Node 22 line.
Ottehr also supports nvm, asdf, and tools that use .node-version.
Install Terraform 1.16
If you do not already have it, install Terraform version 1.16. You can download this directly from HashiCorp's releases page and install it into your path, or use Homebrew. For example to install from HashiCorp on an ARM Mac:
brew install wget # or use cURL
wget https://releases.hashicorp.com/terraform/1.16.4/terraform_1.16.4_darwin_arm64.zip
unzip terraform_1.16.4_darwin_arm64.zip -d /tmp
sudo cp /tmp/terraform /usr/local/bin/terraform
Using Homebrew:
brew tap hashicorp/tap
brew install hashicorp/tap/terraform
This Homebrew formula is not pinned and installs the latest Terraform release, which may be newer than 1.16.x and is not supported by this project. Run terraform version afterwards; if it does not report 1.16.x, use the download above instead.
Check the 1.16.4 releases page if you aren't sure which version to install.
Fork & Clone
Fork — Go to https://github.com/masslight/ottehr/fork and click 'Create fork' to fork the repository.
Clone — Copy and run the clone script for your fork.
git clone [email protected]:{your_profile}/ottehr.git
Then, move into the new directory
cd ottehr
Configure Your Environment
Follow the instructions on setting up a new project in deploy/README.md.
Run the Application
npm run apps:start
Log in and explore the Patient app
The Patient app starts up at http://localhost:3002
By default, the Patient app uses passwordless SMS for authentication. On the login screen, enter your mobile phone number followed by the one-time passcode which is sent to your device.
Log in and explore the EHR
The EHR app starts up at http://localhost:4002
To log into the EHR, check the email address you provided during setup for an invitation to join the EHR application. Click the link, follow the account setup workflow, and then enter your credentials to complete login.
End to End Test Setup Procedure
Ottehr includes a suite of end to end tests that can be used to maintain quality as you customize it for your use case. Learn more about how to configure and use the end to end tests in E2E_README.md.
Repository Structure
This repository uses a monorepo structure.
apps— Frontend web apps- intake — The patient's side
- ehr — The provider's side
packages/zambdas— The application's backend endpoints, deployed as Oystehr Zambdas.packages/{other folders}— Other modules that are imported by apps likeutils,ui-components
Apps
EHR App
Patient Portal App
E2E Documentation
Customization
To customize your Ottehr app
- Update the "VITE_APP_NAME" environment variable from both ehr and intake env folders
- Modify the project name, website and support email from
packages/utils/lib/types/constants.ts
To theme your Ottehr Intake app
Copy the files in
apps/intake/src/themeinto a new folder, for exampleapps/intake/src/myThemeUpdate the theme environment variables to point to your new folders:
THEME_PATH='/src/themes/myTheme'Modify the images, SVGs and colors as needed
Restart the app
To theme your Ottehr EHR app
Copy the files in
apps/ehr/src/themeinto a new folder, for exampleapps/ehr/src/myThemeUpdate the theme environment variables to point to your new folders:
THEME_PATH='/src/themes/myTheme'Modify the images, SVGs and colors as needed
Restart the app