For Implementers

Teams deploying OpenELIS Global at a new laboratory, site, or country — install, configure, integrate, train, hand over.

Who this is for

You're standing up OpenELIS Global somewhere it hasn't been before. That covers everything from a single-lab pilot to a national multi-site rollout. Your work spans hardware procurement, server installation, network setup, custom configuration (test catalog, dictionary, user roles, integrations), data migration if any, and end-user training. Most of what's in this section is independent of country — the country implementation pages (Madagascar, Ethiopia, Indonesia) are reference examples.

The implementer's path

1. Plan

1. Implementation Best Practices — what makes implementations succeed (leadership engagement, training, technical support, deployment). Start here.

2. Server and Workstation Technical Requirements — hardware, network, UPS, infrastructure needs. Use for procurement.

2. Install

1. Install OpenELIS Global — Ubuntu 22.04, Docker, certs, installer script.

2. Analyzers — analyzer interface plugins, how to bring instruments online.

3. If upgrading an existing install: Upgrading OpenELIS 3.x and 2.x and Upgrade from 2.x to 2.7.

3. Configure for your context

1. Configuration Initializer — load your test catalog, dictionary, providers, etc. from data files instead of clicking through the admin UI.

2. Configure property files for Consolidated Server — if you're connecting to a central aggregation server.

3. How to Translate OpenELIS — localization via Transifex if you're shipping in a new language.

4. Integrate

1. Single Sign On Setup — Keycloak / SAML / OAuth2 if needed.

2. OpenMRS Integration — connecting OE to an OpenMRS EMR for incoming lab orders.

3. OpenELIS — Odoo Integration — inventory / equipment / maintenance integration.

5. Train and hand over

Point your end users at the For Lab Staff section. The Madagascar implementation team produced a turnover package in May 2026 that's a useful template — ask the OpenELIS Global team for a copy.

Country implementation examples

Real deployments you can reference:

• Madagascar

• AHRI: Ethiopia

• SILNAS: Indonesia

Where to get help

• OpenMRS Talk — OpenELIS Global category — primary discussion forum. Implementers from other deployments are active there.

• DIGI-UW/OpenELIS-Global-2 GitHub — file an issue if you hit a bug during installation.

• Operational issues post-launch — see the For Operators section.

Stay current

Watch the Releases page to be notified when a new version ships — important for planning your upgrade cadence. Watch the country implementation page that matches your context if you're following a specific reference deployment.