On-prem agent for device connectivity.
[!WARNING] The Medplum Agent is currently in "alpha", and not ready for production use.
Please contact Medplum if you would like to learn more or get involved.
Published releases are built using Github Actions. See the installer build script for details.
The following tools are used to build the agent:
- Node.js
-
Vercel pkg to build the
.exe
file - NSIS to build the installer
- Shawl for the Microsoft Windows service wrapper
- JSign to sign the executable files
The following environment variables are required:
-
SM_HOST
- DigiCert Signing Manager host -
SM_API_KEY
- DigiCert Signing Manager API key -
SM_CLIENT_CERT_FILE_BASE64
- DigiCert Signing Manager client certificate file (base64 encoded) -
SM_CLIENT_CERT_PASSWORD
- DigiCert Signing Manager client certificate password -
SM_CERT_ALIAS
- DigiCert Signing Manager certificate alias
The SM_CLIENT_CERT_FILE_BASE64
environment variable can be generated from the certificate file:
base64 Certificate_pkcs12.p12
References:
Build and run the docker image
docker build -t medplum-agent:latest \
--build-arg GIT_SHA=$(git log -1 --format=format:%H) \
--build-arg MEDPLUM_VERSION=3.0.3 .
docker run --rm \
-e MEDPLUM_BASE_URL="" \
-e MEDPLUM_CLIENT_ID="" \
-e MEDPLUM_CLIENT_SECRET="" \
-e MEDPLUM_AGENT_ID="" \
medplum-agent:latest
Optionally set the MEDPLUM_LOG_LEVEL
environment variable
-e MEDPLUM_LOG_LEVEL="DEBUG"