📦 Releases
Releases
What shipped, what's next, what's deprecated. One home for everything release-related.
Subscribe to this page (bell icon, top-right) to be notified when a new version is announced. See Watch & Stay Current for more subscription options.
Version table
Version | Status | Stability tier | Notes |
|---|
Version | Status | Stability tier | Notes |
|---|---|---|---|
v3.2 (Q1 2026) | DEVELOPMENT TARGET | x.x.3.x production tier when shipped | v3.2 Development Target — new feature roadmap, in active development |
v3.1 | CURRENT PRODUCTION | x.x.3.x — recommended for production deployments | |
v3.0 series | PAST | Production-grade history | |
v2.x series | LEGACY | Still supported but recommend upgrading; see Upgrade docs in For Implementers | |
v1.x and earlier | DEPRECATED | Pre-3.x history; must migrate per the 1.x → 2.x upgrade guide |
Roadmap
Interoperability Roadmap — multi-quarter integration plan covering FHIR, OpenMRS, Odoo, analyzer plugins, and central / consolidated server work
Versioning convention
OpenELIS uses a four-part version: {major}.{minor}.{stability}.{patch}. The third digit signals stability:
x.x.1.x— Alpha (developer testing)x.x.2.x— Beta (limited deployment)x.x.3.x— Production-ready
Production deployments should always run a x.x.3.x version.
What's in each release
Release details live in the child pages linked from the version table above. Each version's child page describes what shipped, what was deprecated, and any breaking changes. For more granular code-level information, see the GitHub releases page.
How to follow releases by role
If you're an implementer or operator
Watch this page — you'll be emailed when a new release is announced.
Watch the GitHub releases page for security patches and bug fixes (often announced there first).
For country-specific deployment notes, also watch your country implementation page (Madagascar, Ethiopia, Indonesia).
If you're a developer
Watch GitHub releases for tag announcements. Watch the Roadmap page for what's coming in the next quarter. Follow Talk for design discussions.
If you're a lab user
Your lab admin will brief you on changes. New features that affect end-user workflows are documented in the For Lab Staff section.
Upgrade planning
Before upgrading any production deployment:
Read the target version's release notes (linked above).
Read the relevant upgrade guide in For Implementers.
Take and verify a backup (Backup Configuration).
Test the upgrade on a non-production environment that mirrors production.
Schedule downtime and communicate with affected lab users.
Where to get help with a release
Upgrade questions — For Implementers
Post-upgrade operational issues — For Operators
Roadmap discussions — OpenMRS Talk
Bug found post-release — Get Help
📋 Last reviewed: 2026-05 · Applies to: OpenELIS Global 3.2.x · Maintained by: the OEG documentation team · Suggest a change