# OpenMRS Reference Application 3 Frontend

OpenMRS Reference Application 3 Frontend is a self-hosted business & finance app. This is the user-friendly interface for OpenMRS, a digital medical record system. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5417/openmrs-reference-application-3-frontend

## Description

This is the user-friendly interface for OpenMRS, a digital medical record system. It provides a visual dashboard for healthcare staff to manage patient information, track appointments, and record clinical notes on a computer or tablet, ensuring essential health data is organised and easy to access during patient care.

## Platform availability

Available on 0 of 10 platforms.

## Health score

58/100 (Fair), 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: 20 (8 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/openmrs/openmrs-reference-application-3-frontend
- Official website: https://demo.openmrs.org
- GitHub: https://github.com/openmrs/openmrs-distro-referenceapplication
- Documentation: https://openmrs.atlassian.net/wiki/spaces/docs/pages/89817092/Hardware and Software Requirements?search_id=c134c0ee-fb18-4d07-849a-e082eb357951

## Common questions

### Which ports should I expose when running the full OpenMRS reference stack locally?

Use port 80 for the main OpenMRS screen at the /openmrs/spa path, port 8069 for Odoo, port 81 for OpenELIS, and port 8084 for Keycloak. If those ports are blocked or mapped incorrectly, login, billing, or lab features can appear broken.

### How should I tell the frontend container where it should be served?

Set the required SPA_PATH environment variable to the URL path where the OpenMRS 3.x frontend should be served. The image serves the built frontend from an nginx container.

### How can I put the frontend and backend behind one entry point?

Use the proxy image, which is a simple nginx reverse proxy. It sits in front of the backend and frontend containers and provides a common internal entry point.

### Can I start a reference application without using the Docker images?

Download the self-contained ZIP archive, expand it, and run the included .jar file to start the Reference Application. It includes an embedded database, an application server, and the option to install demo data.

### How can I compare my local setup to a working example?

Try the public demo before local setup and sign in with the demo user jdoe using the password. It gives you a working example to compare against when your local install first starts up.

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