3.19.2 Release Notes - November 28, 2025

Status: Stable

3.19.2 is a stable release, and all users of OpenLMIS version 3 are encouraged to adopt it.

New Features

  • Pack/Dose Toggle - Users can now seamlessly switch between packs and doses while working in Stock Management or Requisition workflows.

  • Enhanced User Visibility on Stock Cards - Stock card operations now display the user who performed each action, improving traceability and accountability during stock management activities.

Improvements

  • Improved User Import Process - The user import functionality now supports assigning roles directly during import. Additionally, the isEmailVerified field has been removed from the import process to reduce complexity.

  • Added support for PostgreSQL 14.

Bug Fixes

  • Prevent Lodash override by locking global _ to underscore

Compatibility

Important Notice for Implementers Using a Custom Reports Service Forked from Core (Since 3.19.1): If you are using a forked version of the core reports service, ensure your implementation is updated to include the latest changes required for Dashboard reports.

For the necessary updates, refer to the following repository: OpenLMIS Reports - https://github.com/OpenLMIS/openlmis-report/tree/rel-1.4.0-hotfix

All other changes to OpenLMIS 3.x remain backwards-compatible. Any changes to data or schemas are accompanied by automated migrations from previous versions back to version 3.0.1.

All Changes by Component

Version 3.19.2 of the Reference Distribution contains updated versions of the components listed below. The Reference Distribution bundles these components together using Docker to create a complete OpenLMIS instance. Each component has its own public GitHub repository (source code) and DockerHub repository (release image). The Reference Distribution and components are versioned independently.

Components with No Changes

Upgrading from Older Versions

If you are upgrading from OpenLMIS 3.0.x or 3.1.x (without first upgrading to 3.2.x), please review the 3.2.0 Release Notes for important compatibility information about a required PostgreSQL extension and data migrations.

For information about upgrade paths from OpenLMIS 1 and 2 to version 3, see the 3.0.0 Release Notes.

If you are upgrading to version 3.19.1 or greater, the SUPERSET reports will need to be added manually by system administrators. A short manual is available here:

Test Coverage

OpenLMIS 3.19.2 was tested using the established OpenLMIS Release Candidate process. As part of this process, chosen manual test cases were executed to address each change. Any critical or blocker bugs found during the release candidate were resolved.

Download or View on GitHub

OpenLMIS Reference Distribution 3.19.2

Known Issues

  • Report Limitations: The Packs/Doses feature is not available when generating Stock Card and Stock Card Summary reports.

  • Batch Approval: Packs/Doses are not supported in the batch approve requisition view.

  • POD Compatibility: Packs/Doses are not supported in the POD creation.

  • Create Order View (Packs Mode): - The doses input is disabled when the Net Content of a product is equal to one. - The submit modal always displays quantity in doses, regardless of selected mode.

  • Order Fulfillment: Quantity shipped must always be provided in packs.

Other bugs are collected in Jira for troubleshooting, analysis, and resolution on an ongoing basis. See OpenLMIS 3.19.2 Bugs for the current list of known bugs.

To report a bug, see Reporting Bugs.

Contributions

Many organizations and individuals around the world have contributed to OpenLMIS version 3 by serving on committees (Governance, Product, and Technical), requesting improvements, suggesting features, and writing code and documentation. Please visit our GitHub repositories to see the list of individual contributors to the OpenLMIS codebase. If anyone who contributed on GitHub is missing, please contact the Community Manager. Technical development of OpenLMIS is conducted by SolDevelo.

Further Resources

Please see the Implementer Toolkit on the OpenLMIS website to learn more about best practices in implementing OpenLMIS. Also, learn more about the OpenLMIS Community and how to get involved!