Skip to content

Add Docker and Docker Compose workflow for Synthea#1652

Open
sauravkumarsahoo wants to merge 3 commits into
synthetichealth:masterfrom
sauravkumarsahoo:saurav/dockerize-synthea
Open

Add Docker and Docker Compose workflow for Synthea#1652
sauravkumarsahoo wants to merge 3 commits into
synthetichealth:masterfrom
sauravkumarsahoo:saurav/dockerize-synthea

Conversation

@sauravkumarsahoo

@sauravkumarsahoo sauravkumarsahoo commented Apr 16, 2026

Copy link
Copy Markdown

Created a Docker and Docker Compose based workflow to simplify synthetic patient data generation using a container to manage and abstract all dependencies, and allow end-users to focus of running the container with specified .env to get their desired outputs directly.

Summary

  • add a multi-stage Dockerfile to build and run Synthea in containers
  • add docker-entrypoint support for env-driven generation settings and output formats
  • add compose.yaml and .env.example for local Docker Compose runs
  • document Docker and Compose usage in README
  • ensure version.txt is generated before processing resources

Notes

  • local .env is intentionally not included in this PR

Copilot AI review requested due to automatic review settings April 16, 2026 06:38

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a containerized workflow for running Synthea locally via Docker/Docker Compose, including an env-driven entrypoint and documentation updates. This fits the repo by providing a reproducible runtime and build path for generating artifacts without requiring a local Java/Gradle setup.

Changes:

  • Add a multi-stage Dockerfile that builds the shaded Synthea JAR and runs it via an entrypoint script.
  • Add docker-entrypoint.sh to translate env vars into Synthea CLI/config flags (including output format toggles).
  • Add compose.yaml, .env.example, and README instructions for local Compose-based runs; ensure version.txt exists before resource processing.

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
docker-entrypoint.sh New entrypoint to configure Synthea via env vars / CLI passthrough.
Dockerfile Multi-stage build producing a runnable image with the entrypoint.
compose.yaml Local Compose service wiring env vars + output volume mount.
.env.example Example env file documenting supported Compose/runtime variables.
build.gradle Ensure version.txt is generated before resource processing.
README.md Document Docker + Compose usage and configuration options.
.dockerignore Reduce Docker build context (exclude git/build/output/IDE files).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docker-entrypoint.sh Outdated
Comment thread README.md Outdated
Comment thread docker-entrypoint.sh Outdated
sauravkumarsahoo and others added 2 commits April 16, 2026 12:39
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants