ateficial/openmrs-azure-deployment

OpenMRS O3 on Azure - deployment docs, Egypt Disease Heatmap module v2.0.0, and complete setup guide # OpenMRS on Azure Documentation Repository **Platform:** `OpenMRS 2.8.4` | **VM:** `Standard_B2s_v2` | **Region:** `southafricanorth` **Module:** `egyptheatmap v2.0.0` | **Status:** `Deployed` This repository preserves the complete operational record of an OpenMRS O3 deployment on Microsoft Azure together with the custom Egypt Disease Heatmap module that was built, patched, deployed, and verified on that environment. It exists for two reasons: to make the environment reproducible from zero, and to preserve the module source, deployment mechanics, failure history, and final working state in one place. The target system is an Ubuntu 22.04 Azure VM running Docker Compose with four containers: gateway, frontend, backend, and MariaDB. The backend hosts OpenMRS Platform 2.8.4 on Tomcat with Java 21, and it loads `egyptheatmap-2.0.0.omod` from `/openmrs/data/modules/`. The module exposes a frontend heatmap at `/openmrs/spa/heatmap/` and backend JSON endpoints for governorate aggregation, drill-down analysis, concept discovery, and debug inspection. ## System Diagram ```text Developer Machine | | SSH v Azure VM (Ubuntu 22.04) | v Docker | +--> openmrs-gateway-1 +--> openmrs-frontend-1 +--> openmrs-backend-1 | | | +--> /openmrs/data/modules/egyptheatmap-2.0.0.omod | +--> openmrs-db-1 ``` ## Quick Reference | Item | Value | | --- | --- | | Resource group | `openmrs-rg` | | Region | `southafricanorth` | | VM size | `Standard_B2s_v2` | | Operating system | Ubuntu 22.04 LTS | | OpenMRS platform | `2.8.4` | | Java runtime | Amazon Corretto `21` | | Database engine | MariaDB `10.11.7` | | Gateway container | `openmrs-gateway-1` | | Frontend container | `openmrs-frontend-1` | | Backend container | `openmrs-backend-1` | | Database container | `openmrs-db-1` | | Module version | `egyptheatmap 2.0.0` | | Module path | `/openmrs/data/modules/egyptheatmap-2.0.0.omod` | | Frontend URL | `/openmrs/spa/heatmap/` | | Debug URL | `/openmrs/module/egyptheatmap/debug.json` …