> For the complete documentation index, see [llms.txt](https://mets-programme.gitbook.io/ugandaemr-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mets-programme.gitbook.io/ugandaemr-documentation/readme.md).

# Introduction

![UgandaEMR](/files/GVI8HMmLcx90a5VlUBkr)

## UgandaEMR User Manual

This document describes how to use the UgandaEMR to capture and report on patient information.

UgandaEMR is a customization of OpenMRS for Uganda, initially starting with HIV related forms but later expanding to other areas such as Maternal and Child Health services, Tuberculosis treatment following guidelines issued by the Ministry of Health (MoH) under the Health Management Information System (HMIS) manuals.

## Table of contents

* [Introduction](/ugandaemr-documentation/readme.md)
* [Terminologies](/ugandaemr-documentation/terminologies.md)
* [System Setup and Configuration](/ugandaemr-documentation/setup_and_configuration.md)
  * [UgandaEMR 1.x Installation](/ugandaemr-documentation/setup_and_configuration/ugandaemr-1x-installation.md)
  * [UgandaEMR 2.x Installation](/ugandaemr-documentation/setup_and_configuration/ugandaemr-2x-installation.md)
  * [UgandaEMR 3.x Installation](/ugandaemr-documentation/setup_and_configuration/ugandaemr-3x.md)
  * [Post-installation Configuration](/ugandaemr-documentation/setup_and_configuration/post-installation-configuration.md)
* [Backup and Restoration](https://github.com/METS-Programme/ugandaemr-usermanual/blob/master/backup_and_restoration/overview.md)
* [Upgrading UgandaEMR](https://github.com/METS-Programme/ugandaemr-usermanual/blob/master/upgrading/overview.md)
  * [Upgrading/Add Modules](https://github.com/METS-Programme/ugandaemr-usermanual/blob/master/upgrading/overview.md#upgrading-a-module)
  * [Upgrading Warfile](https://github.com/METS-Programme/ugandaemr-usermanual/blob/master/upgrading/overview.md#upgrading-ugandaemr)
  * [Trouble Shooting](/ugandaemr-documentation/overview-1/trouble-shooting.md)
* [Configuring your installation](/ugandaemr-documentation/configuring-your-installation.md)
* [Managing User Accounts](/ugandaemr-documentation/overview-2.md)
* [Provider Management](broken://pages/-M4YKpw-NbzJJ9vFm-vk)
  * [Creating a New Provider](broken://pages/-M4YKpw0bGfjzfWjFtFM)
  * [Making an existing user a provider](broken://pages/-M4YKpw1ToPexgPxS_r4)
* [Patient Management](/ugandaemr-documentation/patient-management.md)
  * [Finding Patient](/ugandaemr-documentation/patient-management/search_patient.md)
  * [Patient Registration](/ugandaemr-documentation/patient-management/patient_registration.md)
* [Fingerprint](/ugandaemr-documentation/fingerprint.md)
  * [Configuration](/ugandaemr-documentation/fingerprint/setup_configurations.md)
  * [Search by Patient Fingerprint](/ugandaemr-documentation/fingerprint/search_add_patient_fingerprint.md)
  * [Add Patient Fingerprint](/ugandaemr-documentation/fingerprint/add-patient-fingerprint.md)
* [Entering Client Information](/ugandaemr-documentation/data_entry.md)
  * [HIV Testing Services Client Card](/ugandaemr-documentation/data_entry/hiv-testing-services-client-card.md)
  * [ART Card](/ugandaemr-documentation/data_entry/art_card.md)
  * [HIV Exposed Infant Card](/ugandaemr-documentation/data_entry/eid_card.md)
  * [HIV Counseling and Testing Client Card](/ugandaemr-documentation/data_entry/htc_card.md)
  * [Maternal and Child Health Cards](/ugandaemr-documentation/data_entry/maternity_and_child_health_data_entry.md)
  * [Safe Male Circumcision](/ugandaemr-documentation/data_entry/smc.md)
  * [Outpatient Form](/ugandaemr-documentation/data_entry/outpatient-form.md)
* [Reporting](/ugandaemr-documentation/reporting.md)
  * [UgandaEMR Reports](/ugandaemr-documentation/reporting/ugandaemr_reports.md)
  * [Cohort Builder](/ugandaemr-documentation/reporting/reporting_cohort_builder.md)
  * [Data Export](/ugandaemr-documentation/reporting/reporting_data_export.md)
  * [Sending Report to DHIS2](/ugandaemr-documentation/reporting/sending_to_dhis2.md)
  * [Sending Metrics Report](/ugandaemr-documentation/reporting/sending_metrics_report.md)
  * [Troubleshooting Report Tips](/ugandaemr-documentation/reporting/report_trouble_shooting.md)
* [Data Quality Checks](/ugandaemr-documentation/data_quality_checks.md)
* [Patient Flags](/ugandaemr-documentation/patient-flags.md)
* [Program Workflows](/ugandaemr-documentation/program-workflows.md)
  * [Differentiated Service Delivery Models (DSDM)](/ugandaemr-documentation/program-workflows/differentiated-service-delivery-models-dsdm.md)
  * [HIV Recency Testing](/ugandaemr-documentation/program-workflows/hiv-recency-testing.md)
  * [ART Regimen Lines](/ugandaemr-documentation/program-workflows/regimen-lines.md)
  * [Tuberculosis](/ugandaemr-documentation/program-workflows/introduction.md)
  * [COVID19](/ugandaemr-documentation/program-workflows/introduction-1.md)
* [Troubleshooting Tips](/ugandaemr-documentation/troubleshooting-tips.md)
* [Uninstalling UgandaEMR](/ugandaemr-documentation/uninstalling-ugandaemr.md)
  * [Unistalling UgandaEMR older versions](/ugandaemr-documentation/uninstalling-ugandaemr/unistallinstalling-ugandaemr-older-versions.md)
* [Point of Care (POC)](/ugandaemr-documentation/point-of-care.md)
  * [Installation and Configuration](/ugandaemr-documentation/point-of-care/installation-and-configuration.md)
    * [Roles](/ugandaemr-documentation/point-of-care/installation-and-configuration/roles.md)
  * [Work Flows](/ugandaemr-documentation/point-of-care/work-flows.md)
    * [Reception](/ugandaemr-documentation/point-of-care/work-flows/reception.md)
    * [Triage](/ugandaemr-documentation/point-of-care/work-flows/traige.md)
    * [Clinician](/ugandaemr-documentation/point-of-care/work-flows/clinician.md)
      * [HIV Clinic](/ugandaemr-documentation/point-of-care/work-flows/clinician/hiv-clinic.md)
    * [Laboratory](/ugandaemr-documentation/point-of-care/work-flows/laboratory.md)
    * [Pharmacy](/ugandaemr-documentation/point-of-care/work-flows/pharmacy.md)
* Data Exchange
  * [ART Access Integration](/ugandaemr-documentation/data-exchange/artaccessintergration.md)
  * [Viral Load Integration](/ugandaemr-documentation/data-exchange/viralloadexchange.md)
  * Patient Data Upload
    * [Uploading Viral Load Results](/ugandaemr-documentation/data-exchange/patient-data-upload/upload_vl_results.md)
* [UgandaEMR Mobile](/ugandaemr-documentation/ugandaemr_mobile.md)
  * [Introduction](/ugandaemr-documentation/ugandaemr_mobile.md)
  * [Download Patients](/ugandaemr-documentation/ugandaemr_mobile/download-patients.md)
* [Release Notes](/ugandaemr-documentation/release-notes.md)
  * [1.0.14](/ugandaemr-documentation/release-notes/ugandaemr-1014.md)
  * [1.0.16](/ugandaemr-documentation/release-notes/ugandaemr-1016.md)
  * [1.0.17](/ugandaemr-documentation/release-notes/ugandaemr-1017.md)
  * [2.0.0](/ugandaemr-documentation/release-notes/ugandaemr-200.md)
  * [2.1.0](/ugandaemr-documentation/release-notes/ugandaemr-210.md)
  * [3.0.0](/ugandaemr-documentation/release-notes/ugandaemr-300.md)
  * [3.0.4](/ugandaemr-documentation/release-notes/ugandaemr-304.md)
  * [3.1.0](/ugandaemr-documentation/release-notes/ugandaemr-310.md)
  * [3.1.3](/ugandaemr-documentation/release-notes/ugandaemr-313.md)
  * [3.2.0](/ugandaemr-documentation/release-notes/ugandaemr-320.md)
  * [3.3.0](/ugandaemr-documentation/release-notes/ugandaemr-330.md)
  * [3.3.7](/ugandaemr-documentation/release-notes/ugandaemr-337.md)
  * [3.4.1](/ugandaemr-documentation/release-notes/ugandaemr-341.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mets-programme.gitbook.io/ugandaemr-documentation/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.