Wiki Spaces


Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack


Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

As the OpenMRS community grows, it is important to offer opportunities for contributors & customers to connect with people in their part of the world. We also need a more coordinated effort to build local representation and expertise. One approach for achieving these goals is to develop local communities. The purpose of this document is to introduce the OpenMRS local community building effort and describe its merits.


Goals for the Local Community Program

  • Develop stronger relationships with community members

  • Encourage leadership in members of local communities

  • Build stronger local representation and identity

  • Attract new volunteers to local and global communities

  • Build and share local knowledge

  • Build stronger connections from local communities to the OpenMRS central leadership


Different Types of


Local Communities

We will support any type of community (dev / implementer / clinician / other?) provided that they can demonstrate collective desire for , which may consist of contributors or customers, developers, implementers, clinicians, or other types of people interested in OpenMRS. All we ask is that the group(s) demonstrate their collective desire for OpenMRS-related collaboration at a local level. A local community could be established in (but is not limited to) the following situations:

  • A group of geographically co-located individuals want to support the implementation of OpenMRS in their region. These individuals could be implementers, developers or clinicians. The type of individuals involved would determine the type of local community created.

  • A group of individuals (geographically co-located or not) what want to support a specific set of feature or content development tasks. These individuals could be implementers, developers or clinicians. The type of individuals involved would determine the type of local community created. This type of community is similar to a special interest group (SIG).

  • Geographically co-located groups that are interested in non implementation specific tasks such as using, building and growing OpenMRS want to meet regularly to discuss concerns.

How to Establish a Local Community


Local groups that already exist will be encouraged to apply for formal recognition. Following an evaluation process by the local community coordination leadership management team, they will be approved and recognized as an official local community.


The baseline requirement for a local community is that they must be able to perform their responsibilitiesregularly meet in person to make progress on the stated goals of their group.

Community Naming

Each community should be able to choose their own community name in their local language. This The official/canonical name of each local community will be "OpenMRS ____ Community", e.g., "OpenMRS Kenya Community", which will exist both in English and in the local language(s) of the geographic place(s) for the community. Additionally, a local community may choose a short name "prefix" in their local language, e.g., "eSaude: OpenMRS Mozambique Community". Selecting a name should be a collaborative process between local community members and the global community management team.

Community Resources


Each community can choose the dedicated resources that they want, but these could include any or all of the following.


Mailing list


Dedicated wiki, wiki space or section (maybe at least one page?)


Dedicated JIRA or (set of) projects


IRC channel?


Dedicated GitHub org or (set of) repositories


Dedicated discourse instance or category

from among dedicated resources such as:

  • Baseline for each community: OpenMRS Talk Category and custom URL, e.g.,

  • Dedicated wiki pages or wiki space

  • Dedicated JIRA issue tracking project(s)

  • IRC channel, e.g., #openmrs-kenya

  • Dedicated GitHub organization or set of repositories

  • Customized Local Community logo


Each local OpenMRS community Local Community will be responsible for the following.:

  1. Scheduling regular in person or virtual meetings


  1. .The local community should meet reasonably regularly to discuss the issues that affect their communities. The meeting schedule and the minutes of these meetings should be made available to the broader OpenMRS community in the interest of knowledge sharing.

  2. Self-government and appointment of leadership


  1. . Each OpenMRS local


  1. community should have some guide of defined community goals and/or documented process. There should also be at least one


  1. community leader that will serve as an interface between the local community and global OpenMRS community.

  2. Developing their own formal agenda and/or focus areas


  1. . Depending on the type of community (developer / implementer / clinician / etc), the objectives of the local communities may differ, but these objectives should nevertheless be definite and made publicly available.

  2. Reporting to the global community


  1. .The activities of local communities should be communicated back to the global community regularly (once per quarter) via the community


  1. leader.


  1. Formal recognition for events/efforts launched by the group


  1. . This could be in the form of announcement make on the various global OpenMRS communication channels (social media / lists / forums / IRC / blog) or by special mention during in-person meetings.

  2. Community specific logos


  1. . Communities can request a group-specific logo that includes a custom variation of the OpenMRS logo and trademark as part of the local community identity.

  2. Goodies for any public events


  1. . A small budget will be available for items such as stickers,


  1. swag, or similar to be produced and made available for the community to distribute at official local events.

  2. Official representation


  1. to


  1. the global leadership team. Community leaders will have regular communication with regional community managers, who will help to ensure the community's success.

Each Local Community Will Have:

  • Technical expertise for OpenMRS-related effortsPreferential scholarships ,

  • Increased priority for travel grants/awards for team members to represent the local community at a given groupOpenMRS at worldwide events, and

  • Additional resources as needed, such as local community-specific discourse and JIRA forumscommunication channels, JIRA projects.


The will be a subcommittee of the leadership team that OpenMRS global community management team will be responsible for the governance of model for local OpenMRS communities. The initial team members will be @michael, @surangak and @pascal. At first this team will be are Michael Downey, Suranga Kasthurirathne, and Pascal Brandt. This team is responsible for setting up the process and will eventually also is responsible for maintaining the process as well considering application applications for new local communities.

Ambassador Roles


Community Leader Role

Local Community leaders will engage with other local communities (via team contacts) regularly help the communities be successful, grow and perform their responsibilities. Once per quarter, each ambassador leader will provide a progress report back to the OpenMRS leadership group about the (one or more) communities they are responsible forglobal community management team about their community's activities during the preceding quarter.

Activity Ideas & Guidelines

The leadership community management team will set up and maintain a wiki page information here that outlines some ideas for local communities.


The leadership team will publish local community guides.   These could include recommendations such as urging all local community members to create and OpenMRS ID, etc.


It will be the task of the Each local community coordination leadership team to develop some documentation (most likely a wiki space / section) detailing all the tasks and processes discussed in this document, in coordination with the community management team, should develop documentation such as a wiki page with details about their local community.


The following might be useful for local community coordinations.coordinators:

  • Ubuntu LoCo Portal. This is the portal for local Ubuntu communities and could provides some valuable resources and examples for developing and managing our community. See the great HOW-TO.

  • Python Local User Groups. The process for starting a Python user group is outlined on this page.

  • Blog post about organising a Mozilla community.