This document is for developers who want to make modifications to OIE. If you are a user who wants to run and use OIE, please review the README or the full documentation see docs.openintegrationengine.org.
There are two ways to build and run OIE locally. The reccommended way is to use Docker. OIE can also be run with traditional build tools.
Both are described here. We suggest the Docker approach for most use cases.
For either approach we also strongly suggest using a launcher. The preferred launcher is Ballista but the Bridge Link launcher and the NextGen Mirth Connect Admin Launcher are known to work.
This is the preferred approach. The Docker image in the engine repository is maintained with the correct JDK, build steps, and best practices.
# Build using docker
docker build -t oie-dev .
# Start an ephemeral image
# NOTE: All data will be deleted on stop due to --rm. Use a volume for "real" use.
docker run --rm -p 8443:8443 oie-dev
# Connect using Ballista or another launcher at https://localhost:8443This is the older, traditional approach from the now closed-source Mirth Connect project. OIE is working to modernize the build system. The Docker approach is likely to be faster and more reliable and better supported.
# Install dependencies manually or use https://sdkman.io/
sdk env install
# Build the server
# NOTE: Building will delete any existing server configuration!
ant -f server/mirth-build.xml -DdisableSigning=true
# Run the server
server/setup/oieserver
# Connect using Ballista or another launcher at https://localhost:8443