New contributor: need help with OpenMRS project setup

Hi everyone :waving_hand:

I’m new to OpenMRS and to open-source contributions in general.

I’m very interested in learning and contributing, but as a beginner I’m finding it challenging to set up the project locally.

I’ve gone through the available documentation and tried setting it up, but I’m not fully sure I’m following the correct or recommended approach.

Could someone please guide me on the proper setup steps or point me to beginner-friendly documentation or issues to get started?

I’m eager to learn and willing to put in the effort. Any guidance would be greatly appreciated.

Thank you!

1 Like

If u are on windows follow the guide :slight_smile:

step-1 set up the java8 and maven step-2 setup IDE like intellij step-3 install docker and setup mysql.

after doing this setup step-4 install openMRS. sdk mvn org.openmrs.maven.plugins:openmrs-sdk-maven-plugin:setup-sdk step-5 setup backend server mvn openmrs-sdk:setup

name the sever →distribution(reference application 2X) → select version(2.13.0 recommended) →press enter for rest of the things.

step-6 start the server using cmd : mvn openmrs-sdk:run -DserverId=YOUR_SERVER_NAME

NOW SETUP COMPLETED.

1 Like

To get started, I recommend focusing on OpenMRS 3 (O3), which is the modern frontend framework for OpenMRS.

You can explore the live O3 demo here:

:backhand_index_pointing_right: https://dev3.openmrs.org

1 Like

Welcome to the community @shubheshkumar0 !

Here is the O3 developer doc : https://openmrs.atlassian.net/wiki/spaces/docs/pages/507576352/O3+Developer+Docs

2 Likes