OpenMRS Reference Application 3 Frontend
This is the user-friendly interface for OpenMRS, a digital medical record system.
Platform availability
Available on 0 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
58/100 Fair
- Maintained
- 100last commit 16 days ago
- Popular
- 42123 GitHub stars
- Easy to install
- 250 install platforms, install notes, Docker image
- Light to run
- 208 GB minimum RAM, runs on ARM
- GitHub stars
- 123
- Open issues
- 30
- Last commit
- 2026-11-05
- Activity
- declining
Checked 15 days ago - source: GitHub (openmrs/openmrs-distro-referenceapplication)
Resources & Compatibility
Minimum requirements: 8 GB RAM, 4 CPU core(s), 100 GB disk. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Know which local ports do what If you are running the full stack locally, the main OpenMRS screen is at http://localhost:80/openmrs/spa, while Odoo uses 8069, OpenELIS uses 81, and Keycloak uses 8084. If these are blocked or pointed at the wrong ports, login, billing, or lab features can appear broken. source
- Try the public demo before local setup Visit https://dev-his.openmrs.org and sign in with jdoe / password. It gives you a working example to compare against when your local install first starts up. source
- Set frontend config URLs before starting Set SPA_CONFIG_URLS to the JSON files the frontend should load, and set ODOO_ADDONS to the Odoo modules you want. Wrong values can leave the app blank or hide the features you are trying to use. source
- Production SSL deployment For production with HTTPS/SSL, create a .env file in the project root setting COMPOSE_FILE=docker-compose.yml:docker-compose.ssl.yml, SSL_MODE=prod, CERT_WEB_DOMAINS to your domain, and CERT_CONTACT_EMAIL, then run docker compose up as usual. source
Fetched 41 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from context7.com, github.com, hub.docker.com, openmrs.org
Community
No community discussions collected yet.