STAND-136: Replace Docker Compose setup steps with OpenMRS SDK in standalone build scripts by Muta-Jonathan · Pull Request #92 · openmrs/openmrs-standalone

Muta-Jonathan · 2025-09-12T07:07:11Z

Issue

https://openmrs.atlassian.net/browse/STAND-136

Description

Currently, the referenceapplication-standalone project relies on Docker Compose steps in the build scripts to start and initialize OpenMRS and its dependencies (e.g., MySQL). This approach introduces several drawbacks:

Requires Docker and Docker Compose pre-installed to setup in automated environments like Bamboo
Adds unnecessary complexity for local developers who may not want to run Docker.

Proposed Change

Remove Docker Compose–based steps from the standalone build scripts.
Integrate OpenMRS SDK (openmrs-sdk-maven-plugin) to manage setup and runtime:
- Automated server setup with predefined runtime properties.
- Automatic runtime properties and checksum generation.

Benefits

Simplifies local setup for developers.
Provides consistent environment across local development and CI/CD pipelines.

Screenshots

…ndalone build scripts

Muta-Jonathan · 2025-09-12T07:07:57Z

cc @Ruhanga @dkayiwa

mherman22 · 2025-09-12T08:31:58Z

scripts/start-docker-and-wait.sh

+PID=$(lsof -ti:8080 || true)
+if [ -n "$PID" ]; then
+  echo "⚠️ Port 8080 is in use by PID $PID. Stopping it..."
+  kill -9 $PID


This works if I don’t care about what’s running on port 8080. But what if I do have a process I want to keep there? Killing it blindly might stop something important. Maybe we should add a check or a prompt before killing, or even allow overriding the port instead of always freeing 8080.

Something like:

echo "Port $PORT is in use by PID $PID." read -p "Do you want to stop this process? (y/N) " choice

I'd prefer to use a free port within a specific range, such as 8000 to 9000.

oh that makes sense @mherman22 .... let me update it to go as @Ruhanga suggests

Muta-Jonathan · 2025-09-12T11:33:10Z

cc @Ruhanga @mherman22 @dkayiwa

dkayiwa · 2025-09-12T12:30:25Z

@Muta-Jonathan have you tested this?

Muta-Jonathan · 2025-09-13T18:50:37Z

@Muta-Jonathan have you tested this?

yes @dkayiwa

Ruhanga · 2025-09-15T12:33:06Z

scripts/start-docker-and-wait.sh

+connection.url=jdbc:mariadb://127.0.0.1:3308/openmrs-example?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull
+connection.username=root
+connection.password=Admin123


Is there a way to detect whether a MySQL instance is running on the host machine or inside a Docker container, so the script can dynamically choose the correct connection URL—either jdbc:mariadb://127.0.0.1:* for a host-based instance, or jdbc:mariadb://<mysql-service-name>:* for a Docker-based instance?

sure @Ruhanga let me address it

Muta-Jonathan · 2025-09-23T09:23:11Z

cc @Ruhanga @dkayiwa

dkayiwa · 2025-09-24T22:09:55Z

@Muta-Jonathan do you know why this standalone goes all the way to over 500 mbs?

dkayiwa · 2025-09-24T22:25:26Z

@Muta-Jonathan are you also able to run this command? mvn package -Drefapp.version=3.5.0

Muta-Jonathan · 2025-09-26T10:51:59Z

mvn package -Drefapp.version=3.5.0

let me addess this

Muta-Jonathan · 2025-09-26T11:02:08Z

@Muta-Jonathan do you know why this standalone goes all the way to over 500 mbs?

@dkayiwa seems mine is about 492.4mb when zipped and around Total ≈ 705 MB unpacked
Basically this is due to AppData including modules, checksums

and to break it down

AppData: 398.7 MB (~56%)
Tomcat: 105.9 MB (~15%)
Standalone JAR: 198.6 MB (~28%)
DB Dumps + misc: ~3 MB (<1%)

Ruhanga

Thanks @Muta-Jonathan for your continued effort on this. It's becoming clear that we'll likely need to move away from Bamboo in the near future and so, relying on Dockerized builds may soon be obsolete, especially with the greater flexibility offered by GitHub Actions.

With this in mind, I'd suggest we consider closing this PR in favor of a GitHub Actions-based approach.

dkayiwa · 2025-09-26T12:21:01Z

@Ruhanga doesn't GitHub actions offer dockerised builds?

Ruhanga · 2025-09-26T13:36:16Z

Absolutely. GitHub does support Dockerized builds, along with a variety of other build environments like Java and more. This means we're no longer limited or constrained to using the SDK solely for the sake of Dockerized builds, as is the case with Bamboo.

Muta-Jonathan · 2025-09-27T19:43:40Z

Absolutely. GitHub does support Dockerized builds, along with a variety of other build environments like Java and more. This means we're no longer limited or constrained to using the SDK solely for the sake of Dockerized builds, as is the case with Bamboo.

does this mean we need to switch back the script to use docker compose rather than yhe sdk?

Ruhanga · 2025-09-28T15:33:39Z

does this mean we need to switch back the script to use docker compose

@Muta-Jonathan this is the case already. Introducing the SDK was primarily to resolve build issues on Bamboo, due to complications with Docker-in-Docker builds.

What we would need, in favour of Github actions already, is a workflow that is able to publish a standalone to SourceForge given a released distro.

Muta-Jonathan · 2025-09-29T01:18:44Z

thanks @Ruhanga that makes sense
@dkayiwa since the dockerised approach was faster at build time I think its okay we close out this since github actions can handle the build now

dkayiwa · 2025-09-29T08:22:32Z

@Muta-Jonathan can you point me to the github actions that are handling the build now?

Muta-Jonathan · 2025-09-29T08:28:43Z

@Muta-Jonathan can you point me to the github actions that are handling the build now?

Basically am meaning these Github actions on PR builds https://github.com/openmrs/openmrs-standalone/actions/runs/17127633070/job/48583108852 One thing we are missing for the one which would publish to SourceForge

dkayiwa · 2025-09-29T08:34:13Z

Can we create that such that we achieve our ultimate goal?

Muta-Jonathan · 2025-09-29T08:49:50Z

Can we create that such that we achieve our ultimate goal?

sure i think @Ruhanga needs to create this workflow

build the project from this branch
publish the zip from target folder to sourgeforge

Since He has the credentials

Ruhanga · 2025-10-03T07:42:56Z

@Muta-Jonathan where you able to update the database damps to contain the released Ref Apps metadata, as the current ones seem to have been generated using the pre-release distro?

Muta-Jonathan · 2025-10-03T10:13:29Z

@Ruhanga Let me see if i can make the database dumps be extracted at build time instead of manually to avoid this manual update each time

cc @dkayiwa

Muta-Jonathan · 2025-10-21T04:41:20Z

@dkayiwa @Ruhanga Have been looking into this and am thinking why not to go with the sdk approach instead

Simply because this helps to get rid of docker requirement at build time ... been playing with docker these weeks but seems to extract demo sql but sometimes misses the table data on extraction ... that's why am suggesting this ...one downside is it takes sometime than docker build but ready to hear your suggestions

dkayiwa · 2026-02-06T12:24:10Z

@Muta-Jonathan is this still relevant?

Muta-Jonathan · 2026-02-08T10:54:19Z

Since we decided to move away from bamboo builds am thinking I can close this out.
The challenge this PR was addressing was all about the Bamboo builds now this will be handled by github actions

Is there any objections to this (me closing this) @Ruhanga @dkayiwa ?

STAND-136: Replace Docker Compose setup steps with OpenMRS SDK in sta…

9cc66eb

…ndalone build scripts

Muta-Jonathan changed the title ~~Stand 136: Replace Docker Compose setup steps with OpenMRS SDK in standalone build scripts~~ STAND136: Replace Docker Compose setup steps with OpenMRS SDK in standalone build scripts Sep 12, 2025

Muta-Jonathan changed the title ~~STAND136: Replace Docker Compose setup steps with OpenMRS SDK in standalone build scripts~~ STAND-136: Replace Docker Compose setup steps with OpenMRS SDK in standalone build scripts Sep 12, 2025

removing harding-coding dump version to be imported

dba5d7a

mherman22 reviewed Sep 12, 2025

View reviewed changes

using tomcat port as range of 8000 to 9000.

9dbdc4a

Ruhanga reviewed Sep 15, 2025

View reviewed changes

dynamically choose the correct connection URL

0ef0842

addressing the debug port being used

15cd4a1

Ruhanga reviewed Sep 26, 2025

View reviewed changes

jwnasambu requested review from Ruhanga, dkayiwa and mherman22 February 6, 2026 11:53

dkayiwa closed this Feb 9, 2026

Conversation

Muta-Jonathan commented Sep 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue

Description

Proposed Change

Benefits

Screenshots

Uh oh!

Muta-Jonathan commented Sep 12, 2025

Uh oh!

mherman22 Sep 12, 2025

Choose a reason for hiding this comment

Uh oh!

Ruhanga Sep 12, 2025

Choose a reason for hiding this comment

Uh oh!

Muta-Jonathan Sep 12, 2025

Choose a reason for hiding this comment

Uh oh!

Muta-Jonathan commented Sep 12, 2025

Uh oh!

dkayiwa commented Sep 12, 2025

Uh oh!

Muta-Jonathan commented Sep 13, 2025

Uh oh!

Ruhanga Sep 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Muta-Jonathan Sep 23, 2025

Choose a reason for hiding this comment

Uh oh!

Muta-Jonathan commented Sep 23, 2025

Uh oh!

dkayiwa commented Sep 24, 2025

Uh oh!

dkayiwa commented Sep 24, 2025

Uh oh!

Muta-Jonathan commented Sep 26, 2025

Uh oh!

Muta-Jonathan commented Sep 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

and to break it down

Uh oh!

Ruhanga left a comment

Choose a reason for hiding this comment

Uh oh!

dkayiwa commented Sep 26, 2025

Uh oh!

Ruhanga commented Sep 26, 2025

Uh oh!

Muta-Jonathan commented Sep 27, 2025

Uh oh!

Ruhanga commented Sep 28, 2025

Uh oh!

Muta-Jonathan commented Sep 29, 2025

Uh oh!

dkayiwa commented Sep 29, 2025

Uh oh!

Muta-Jonathan commented Sep 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dkayiwa commented Sep 29, 2025

Uh oh!

Muta-Jonathan commented Sep 29, 2025

Uh oh!

Ruhanga commented Oct 3, 2025

Uh oh!

Muta-Jonathan commented Oct 3, 2025

Uh oh!

Muta-Jonathan commented Oct 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dkayiwa commented Feb 6, 2026

Uh oh!

Muta-Jonathan commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Muta-Jonathan commented Sep 12, 2025 •

edited

Loading

Ruhanga Sep 15, 2025 •

edited

Loading

Muta-Jonathan commented Sep 26, 2025 •

edited

Loading

Muta-Jonathan commented Sep 29, 2025 •

edited

Loading

Muta-Jonathan commented Oct 21, 2025 •

edited

Loading

Muta-Jonathan commented Feb 8, 2026 •

edited

Loading