OpenELIS Global2 Docker Compose Setup

Docker Compose setup for OpenELIS-Global2

You can find more information on how to set up OpenELIS at our docs page

ONLINE INSTALLATION

Updating the DB Passord (Optional)

1. Update the Enviroment vaiable OE_DB_PASSWORD in the .env file for the 'clinlims' user

2. Update the Enviroment vaiable ADMIN_PASSWORD in the .env file for the 'admin' user

Configuring the TLS Certificate (Optional)

By default the proxy serves the self-signed certificate generated by the certs service. For a real deployment you can point the proxy at your own certificate and key using four environment variables in the .env file:

Variable	What it sets	Default
OE_CERTS_PATH	Where the certificate directory comes from — a Docker named volume by default, or a host path in deployment	certs-vol
OE_KEYS_PATH	Where the private-key directory comes from	keys-vol
OE_NGINX_CERT	Which certificate file (filename) nginx loads from OE_CERTS_PATH	apache-selfsigned.crt
OE_NGINX_KEY	Which key file (filename) nginx loads from OE_KEYS_PATH	apache-selfsigned.key

• A bare name (e.g. certs-vol) uses the Docker named volume filled by the certs service. A value containing a slash (e.g. /home/ubuntu/certs2026) is mounted as a host path instead — put your real cert/key in that directory.
• OE_NGINX_CERT / OE_NGINX_KEY are the filenames inside those directories; nginx is rendered to load them at startup, so they must match the files present.

Example: serving real certs from /home/ubuntu/certs2026/cert.crt and cert.key:

OE_CERTS_PATH=/home/ubuntu/certs2026
OE_KEYS_PATH=/home/ubuntu/certs2026
OE_NGINX_CERT=cert.crt
OE_NGINX_KEY=cert.key

Running OpenELIS Global with docker-compose

docker-compose up -d

The Instance can be accessed at

Instance	URL	credentials (user: password)
OpenELIS Frontend	https://localhost/	admin: adminADMIN!

OFFLINE INSTALLTION

For offline Installtion,where theres no Intenet acess,

1. Download the OpenELIS-Global Docker Installer zip file from the Release Artifacts

2. Unzip the OpenELIS-Global Docker Installer zip file

   tar xzf OpenELIS-Global_<verion>_docker_installer.tar.gz
   

3. Move to directory of the Unziped OpenELIS-Global Docker Installer file

   cd OpenELIS-Global_<verion>_docker_installer
   

4. For installing OpenELIS-Global2 the first time ,Load the images and start the containers by running

   ./run.sh
   

5. For Upgrading OpenELIS-Global2 with an existing docker installer ,only Load the images form the new docker installer with the following command, update the image tags to the new docker installer version and re-satrt Global Global containers in your existing old Docker installer

   ./upgrade.sh