Have you tried turning it off and back on again?

This may be the most basic of advice, but the first step should always be to restart the docker containers.

sudo docker restart

Disk Space Running Out

System monitoring applications should be installed alongside OE so that disk space shortages can be discovered ahead of time. When a disk is near full, the following solutions may be able to help.

Check mounted log files

The following instructions will require the user have ssh access to the server running OE. OE mounts log files in 2 locations on the system: /var/lib/openelis-global/logs/ and /var/lib/openelis-global/tomcatLogs/. If the files here are getting large, the cleanup script is not successfully deleting them. Ensure that /var/lib/openelis-global/lib/logCleanup.sh can be run. The thresholds within /var/lib/openelis-global/lib/logCleanup.sh can also be modified.

Check docker daemon logging

Docker containers also retain log files. The docker-compose.yml should have logging configured so that log files don't grow too large. If this isn't working, or if you are using an older version of OE (introduced v2.5.3.3), then ensure that the docker daemon is configured with reasonable constraints upon logging. It is recommended to use 'local' logging for docker. Instructions for configuring the docker daemon are at docs.docker.com.

Ensure you:

restart the docker service after configuring (sudo system docker restart)
recreate the docker containers by bringing them down and then back up again (sudo docker-compose down, sudo docker-compose up -d)

Suggested configuration at /var/lib/docker/daemon.json:

{
  "log-driver": "local",
  "log-opts": {
    "max-size": "20m",
    "max-file": "50"
  }
}

Infohighway connection problems

If the connection to the infohighway appears not to be working:

1. Verify network connectivity

Run telnet xxx.xxx.xxx.xxx 443 with the infohighway IP. If the connection can't connect, contact a network administrator to allow the traffic.

2. Verify connection info in OE

Login as admin, navigate to Admin > External connections. Confirm:

Connection type: Info Highway
Authentication Type: Basic
Username and password are correct
Endpoint URL: https://infohighway.govmu.org/ih-webservice/soap/query

3. Verify extra_hosts entry

SSH into the OE server. Verify /var/lib/openelis-global/config/EXTERNAL_HOSTS has an entry like infohighway.govmu.org:xxx.xxx.xxx.xxx. Re-run the latest installer (setup_OpenELIS.py). Verify docker-compose.yml has an extra_hosts entry under oe.openelis.org matching that file. If missing, add it and run sudo docker-compose up -d. Then retry patient search by National ID. If still failing, contact a higher level of support.

📋 Last reviewed: 2026-05 · Applies to: OpenELIS Global 3.2.x · Maintained by: the OEG documentation team · Suggest a change

Troubleshooting