Platform 2.8.0-alpha pre-release Notes.

Platform 2.8.0-alpha pre-release Notes.

Overview

Release Date July 11th 2025.

Release Manager: SSEBAANA Suubi Joshua

OpenMRS Platform 2.8.0-alpha is a preview release that introduces new features and improvements while maintaining backward compatibility with existing modules and implementations.

Alpha Release Notice This is an alpha release intended for testing and evaluation purposes. It is not recommended for production use. Please report any issues you encounter to help improve the final release.

What's New

Major Features

Technical Requirements

System Requirements

  • Java: OpenJDK 8 or Oracle JDK 8 (minimum)

  • Database: MySQL 5.7+ or PostgreSQL 10+

  • Application Server: Tomcat 8.5+ or similar servlet container

  • Memory: Minimum 2GB RAM recommended

Compatibility

  • Module Compatibility: Compatible with modules built for OpenMRS 2.x

  • Database Migration: Automatic migration from 2.7.x versions

  • API Compatibility: Maintains backward compatibility with existing REST APIs

Installation to test locally

Download

  1. Download the OpenMRS Platform 2.8.0-alpha WAR file here or for Docker here

  2. Install using SDK (find out how to do that here)

Upgrading from Previous Versions

  1. Backup your database and application data

  2. Stop your OpenMRS instance

  3. Replace the existing WAR file with the 2.8.0-alpha version

  4. Start OpenMRS - database migrations will run automatically

  5. Verify all modules are compatible and functioning correctly

Module Compatibility Notes

  • Some third-party modules may require updates for full compatibility

  • Test thoroughly with your specific module configuration

  • Check the OpenMRS Add-Ons Index for module compatibility status

Breaking Changes

Testing & Feedback

How to Test

  • Deploy in a non-production environment

  • Test with your typical workflow and module configuration

  • Pay special attention to specific areas that need testing

Reporting Issues

Feedback Areas

We're particularly interested in feedback on:

  • Performance and usability

  • Integration with existing workflows

  • Overall system stability and performance