# openmrs/openmrs-core

> openmrs-core is a Java application for OpenMRS, a patient-based medical record system that gives healthcare providers a customizable electronic medical record system (EMR). It contains the OpenMRS API and web application code, which Maven builds into a WAR file that is deployed to an application server. The main language is Java, and Liquibase handles changes to the database.

Source: https://github.com/openmrs/openmrs-core
Indexed: commit 5167075 on 2026-07-20 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Java
- Stars: 1,995 at index time
- Code health: 7.4/10, Good
- Last commit: 2026-06-25

## Install

From the README: https://github.com/openmrs/openmrs-core

Clone the openmrs-core repository.
    git clone https://github.com/openmrs/openmrs-core.git

Move into the openmrs-core folder.
    cd openmrs-core

Build the application, which writes the WAR file to webapp/target/openmrs.war.
    ./mvnw clean package

Build a development Docker image.
    docker compose build

## How to use

From the webapp directory, run the application in Jetty for development.
    ../mvnw jetty:run

## How it works

Requests and domain data enter through the API and web layers. The api/ directory holds the Java and resource files that build the API jar, and api/src/main/java/org/openmrs/api/context/Context.java gives code access to the services. The domain model is defined in classes such as api/src/main/java/org/openmrs/OpenmrsObject.java, which other parts of the code build on. The web/ directory holds the Java and resource files used in the web application, and webapp/ holds the files used to assemble the openmrs.war file. Build output is written to webapp/target/openmrs.war, which runs on an application server such as Tomcat or Jetty.

- META-INF/services/liquibase.change.Change: entry point
- META-INF/services/liquibase.datatype.LiquibaseDataType: entry point
- META-INF/services/liquibase.logging.LogService: entry point
- META-INF/services/liquibase.sqlgenerator.SqlGenerator: entry point
- META-INF/services/org.jboss.logging.LoggerProvider: entry point
Modules: api, web, liquibase, root, webapp, test-suite, .github, monitoring. 1,350 files, 157,503 lines, 17,244 symbols.

## Code health

- Score: 7.4/10 (Good)
- Rank: #115 of 4,000+ indexed repos
- Hotspots: web/src/test/java/org/openmrs/web/filter/initialization/InitializationFilterE2ETest.java, web/src/main/java/org/openmrs/web/filter/initialization/InitializationFilter.java
- Lowest file: api/src/main/java/org/openmrs/module/ModuleUtil.java
- Dead code: 65 findings

## Maintenance

- Last commit 2026-06-25
- bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/openmrs/openmrs-core/security

## More

- Page: https://repowise.dev/repo/openmrs/openmrs-core
- Ask this codebase: https://repowise.dev/repo/openmrs/openmrs-core/chat
- Docs: https://repowise.dev/repo/openmrs/openmrs-core/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/openmrs/openmrs-core
