# OpenMRS Reference Application 3 Backend

OpenMRS Reference Application 3 Backend is a self-hosted development app. OpenMRS 3.0 Reference Application Backend is the self-hosted backend for the OpenMRS 3.0 Reference Application, a web-based medical record system. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5399/openmrs-reference-application-3-backend

## Description

OpenMRS 3.0 Reference Application Backend is the self-hosted backend for the OpenMRS 3.0 Reference Application, a web-based medical record system. It provides the backend services, application programming interface (API), and data access used by the OpenMRS frontend and related health IT integrations. It is intended for health IT teams deploying the OpenMRS 3 Reference Application who want a tested starting point for local or production use.

## Platform availability

Available on 0 of 10 platforms.

## Health score

70/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 16 days ago)
- Popular: 42 (123 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 100 (256 MB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/openmrs/openmrs-reference-application-3-backend
- Official website: https://demo.openmrs.org
- GitHub: https://github.com/openmrs/openmrs-distro-referenceapplication

## Common questions

### Does the openmrs-reference-application-3-backend Docker image include a database?

No. It provides only the OpenMRS backend. You must provide a database for OpenMRS yourself.

### Which local ports need to be free for the local install?

OpenMRS is expected on port 80 under /openmrs/spa, Odoo on port 8069, OpenELIS on port 81, and Keycloak on port 8084. If those ports are in use or blocked, the app, login, lab, or ERP parts may be unreachable.

### Which environment variables should be set before starting OpenMRS and Odoo?

Set SPA_CONFIG_URLS and ODOO_ADDONS. The OpenMRS web app and Odoo use them to load config pages and ERP modules, so missing or wrong values can cause incomplete startup behavior.

### Is OpenELIS required for the lab integration?

No, OpenELIS lab integration is optional. Start the optional OpenELIS Docker Compose service only if lab functionality is needed, and point its lab settings to the correct local or remote server.

### Is there a self-contained option that includes a database and demo data?

Yes. A self-contained ZIP archive includes an embedded database and application server, with an option to install demo data for sample patients. Expand the archive and run the .jar file to start the Reference Application.

---
Source: Our Local Host (https://ourlocalhost.com/app/5399/openmrs-reference-application-3-backend), the self-hosted and open-source app directory.
