Skip to main content

Local development setup

Ready to get started developing Medplum on your local machine? Great! First, you'll need to set up your own copy of the Medplum repository to work on, by forking the repository into your own GitHub account. Note: If you don't want to make changes and submit them back to the Medplum project, you can skip this step and proceed directly to the next step.

After you've created your own fork of the Medplum repository, copy it to your local machine to work on by cloning it.

Clone the repo

If you created a fork to submit Pull Requests from, you'll need to ensure you clone your fork, rather than the official Medplum repository. Otherwise, use below to copy the official repository, which you can use to build and run the app locally.

git clone{YOUR GITHUB USERNAME}/medplum.git medplum

If you get an error saying Permission denied using ssh, you can refer to the Github docs on setting up SSH keys. Alternatively, you can use the https method as a fallback.

git clone{YOUR GITHUB USERNAME}/medplum.git medplum

That will create a complete copy of the project source code on your local machine, including code for the Medplum Server, Medplum App, and associated libraries.

In the next step, we'll build the application and run the tests.