OpenMRS 3 demo version not working

Ask OpenMRS
1

Application Name: Reference Application Version Number: OpenMRS 3 (O3 )

Question: I am trying to access the OpenMRS 3 demo environment at OpenMRS , but the page loads completely blank — no UI elements, no error messages, just an empty white screen.

Steps to reproduce:

  1. Open a web browser and navigate to OpenMRS
  2. Wait for the page to finish loading
  3. The page renders blank (white screen) with no visible content

What I have tried:

  • Hard refresh (Ctrl+Shift+R)
  • Tested on multiple browsers (Chrome, Firefox)
  • Cleared browser cache and cookies
  • The console displays a series of errors with the demo server

Expected behavior: The OpenMRS 3 login page should render correctly. Actual behavior: Blank white page with the React rendering error described above.

Any guidance would be appreciated.

2

Hey! :waving_hand:

A blank white screen in OpenMRS 3 usually points to a frontend (React) issue rather than just a browser problem.

Since you’re seeing console errors, you can check a few things:

Open DevTools and go to the Network tab, then see if any JS files are failing (404 or 500) or if API calls to /openmrs/ws are failing

Look at the console errors. Messages like “Cannot read properties of undefined” often indicate frontend issues

Try disabling browser extensions like ad blockers

Try opening /openmrs/login.htm directly. If that works but the UI still doesn’t load, it’s likely a frontend issue

It’s also possible the demo environment is temporarily broken or mid-deployment

If you can share a screenshot of the console errors or network failures, it would help narrow it down further :+1:

3

Hay @einerrcastrellon, the blank screen in the OpenMRS 3 demo environment is caused by the backend failing to start properly there could be a database update mismatch and therefore the initialsetup page shows a startup error (“Should not be here because updates were run previously”), which means the demo server itself is misconfigured or stuck in an incomplete upgrade state. This is not a browser issue on your side but a server-side failure. So the React-based O3 frontend (/spa/home) relies on the backend API. Since the backend is not running, the frontend cannot render, resulting in a blank white screen.

Screenshot 2026-04-12 114903
Screenshot 2026-04-12 1149031895×977 79.8 KB

1 Like
4

try out this one. OpenMRS for dev3. admin and Admin123 are the credentials.

1 Like
5

Ahh got it, thanks for the detailed explanation :+1:

That explains the blank screen well if the backend isn’t starting properly, the O3 frontend won’t be able to load anything since it depends on those APIs.

@einerrcastrellon you can try the alternate dev3 instance shared above to confirm it’s working on your side. If that loads fine, then it’s definitely an issue with the demo server and not your setup.