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.


Primary Mentor

Backup Mentor

Pascal Brandt Harsha Kumara
Assigned toTBDSai Sandeep Mutyala


The OpenMRS Atlas provides a voluntary registry of OpenMRS implementations all over the world. The server code was originally written using PHP and has been adapted a few times over the past decade. During GSoC 2016 and 2017, a new version of the Atlas server code was written in node Node.js as the Atlas 3.0 Project, but this new, node-based server code was never fully deployed in production. During In 2017, the  the broader OpenMRS infrastructure was migrated and updated so all services are deployed using Docker and our single-signon was switched to use LDAP. As a result, some of the functionality of the PHP-based Atlas has been lost. Given users can could no longer authenticate to create or update their markers and, by default, untouched markers fade over time, the existing markers are beginning to disappear from the Atlas!OpenMRS Atlas was literally fading away in disrepair.


The goal of this project is was to address the remaining tasks to bring the node-based OpenMRS Atlas into production. This will include included some code changes, some additional features (most importantly, adding LDAP support), and ensuring the application can could be deployed and configured by our infrastructure (i.e., using Docker).


  • Users can authenticate via LDAP
  • Users can add and update markers
  • Atlas module works on supported versions of the Reference Application
  • Product is deployed to replace Atlas 2.1

Extra Credit

  • All external/user URLs should have “rel=nofollow” (

  • Allow admins to access to disable/delete anything suspicious

  • Notify admins when new site is added (including image)

  • Atlas module works with new Atlas server on both new and legacy versions of OpenMRS 

Progress TODO List

Primary Goals

Additional Goals

Features Implemented / Fixed

  • Implemented Login through LDAP 

Image Added

  • Fixed addition, updating and deletion of markers

Image AddedImage Added

  • Added admin functionality and created an admin page

Image Added

  • Fixed the Atlas module

Image Added

  • Created an RSS feed

Image Added

  • Implemented upload of markers

Image Added

  • Implemented download of map screenshots

Image Added

  • Allowed admins to download marker data

Image Added

  • Allowed markers to have co-owners

Image AddedImage Added

  • Added Email notifications to notify owners of their fading markers

Image Added

  • Implemented search for markers

Image Added

  • Created a data page

Image Added


Infrastructure provided

  • Staging LDAP with users in both atlas-user and atlas-admin groups
  • Staging server (docker host)
  • Bamboo pipeline deploying image to docker hub AND docker image to staging server
  • LDAP credentials
  • SMTP credentials
  • S3 bucket to store - and serve - images (if desired)
  • Backup with current data (atlas 2.1)