Community Help Desk

Publishing your OpenMRS Module

Last Updated: Nov 14, 2014 08:59PM UTC

The module repository is simply a collection of modules that developers have created and uploaded.  They have not necessarily been tested by OpenMRS, so please keep that in mind. Nefarious modules are removed once reported.

Where is the modules directory?


The repository is hosted at:

How to Upload a New Module

  1. Visit
  2. For new modules (not upgrades), click on the "Upload New Module" button and sign in with your OpenMRS ID, if necessary.
  3. Provide all relevant details and submit the form.

Updating a Module


If you are trying to update an existing module not owned by you, contact the module developer for permission, or open a help desk case if they are unavailable.

Who Can Upload a Module?


Every developer with an OpenMRS ID is allowed to create a module page, upload, and manage their module in the directory.

Advantages of Using the Directory

  • For developers: The config.xml inside of your module has a tag for "updateURL". OpenMRS uses this url to check for updates to your module. If you upload a new version to the module repository, all users of your module will be notified that an update is pending.
  • For implementations: The repository is a central place to find available modules. Most modules downloaded from the repository will be linked back to it so that you can be notified when an update is available.



All modules in the directory are free to upload and free to download. The source code for the modules may or may not be open source, that is up to the individual developer. The main OpenMRS modules directory will never charge for downloading modules. If a module chooses to charge for use of a module (via some key or the like) that is up to them.


Help Resources
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found