@medplum/agent

Medplum Agent

On-prem agent for device connectivity.

Building

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:

• Sign with SMCTL
• GitHub Actions script integration with PKCS11
• Sign with jSign
• JSign
• Shawl
• NSIS

Docker Image

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"