# OpenMRS Reference Application Distro

OpenMRS Reference Application Distro is a self-hosted, pre-configured OpenMRS 3.0 deployment for clinics that want a ready-to-run electronic medical record system for registering patients, managing visits, and storing. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5787/openmrs-reference-application-distro

## Description

OpenMRS Reference Application Distro is a self-hosted, pre-configured OpenMRS 3.0 deployment for clinics that want a ready-to-run electronic medical record system for registering patients, managing visits, and storing clinical data.

## Platform availability

Available on 0 of 10 platforms.

## Health score

63/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 3 days ago)
- Popular: 42 (125 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)
- Security check: 95 (no serious findings, CI, tests)

## Links

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

## Common questions

### Which local ports should I check after starting the Dockerized OpenMRS stack?

The main app is usually on port 80 under the /openmrs/spa path, with Odoo on port 8069, OpenELIS on port 81, and Keycloak on port 8084. If a page fails, check that Docker published the ports and your firewall allows them.

### Which environment variables should I keep when deploying the frontend and Odoo?

Keep SPA_CONFIG_URLS set to the list of frontend configuration files and ODOO_ADDONS set to the needed Odoo add-on modules. Without them, the web app may not find its settings and Odoo may be missing modules.

### Where does the backend image get its reference application Initializer configuration?

It is drawn from the distro sub-directory in the repository. That directory includes a full Initializer configuration intended as a starting point for the reference application.

### Have users reported trouble installing the reference application from scratch?

One forum user reports several unsuccessful attempts to install the reference application from scratch with OpenMRS Core 2.5.x and 2.6.0.

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