For AI agents: the documentation index is at /docs/mdmbox/llms.txt. A Markdown version of this page is available at /docs/mdmbox/deployment/versions-and-compatibility.md or by requesting it with the Accept: text/markdown header.
MDMbox Docs

Versions and compatibility

MDMbox is compatible with Aidbox from the current LTS through the latest release, including LTS. Every MDMbox release is tested with each Aidbox monthly version in that range. MDMbox and Aidbox version numbers do not need to match.

Compatible Aidbox versions for each MDMbox monthly version are listed in Release notes.

Aidbox App integration

Available from: 2609.0 for MDMbox UI and API access through Aidbox.

MDMbox supports serving its Admin UI and API through Aidbox. Clients use the Aidbox address: /mdmbox for the UI and /api/* for API operations. Aidbox authenticates requests, evaluates AccessPolicies, and forwards permitted requests through App/mdmbox, which MDMbox registers at startup.

With authentication enabled, the Admin UI is available only through Aidbox. For local development, see direct Admin UI access. To require the Aidbox route for all protected API operations, set MDMBOX_API_AIDBOX_APP_ONLY=true. Direct requests to those operations then return HTTP 403, so clients cannot bypass the AccessPolicies configured in Aidbox. Health checks and API documentation remain public. See Authentication for access setup and Configuration reference for the required settings.

Available from: MDMbox 2610.0 with Aidbox 2610.0 or later for response streaming. We recommend Aidbox 2610.0 or later for App integration; see Release notes for the tested versions. Earlier supported Aidbox versions buffer each App response before sending it to the client. The UI and completed downloads still work, but intermediate UI updates arrive at the end of the request and large or concurrent bulk and continuous matching exports require enough Aidbox memory to hold their complete response bodies.

Docker image tags

Available from: edge for the Admin UI version label. The bottom of the left navigation, above API Docs, shows the running version, such as 2610.0, or edge:<short SHA> for a development image. Hover over the label to see the full commit SHA when available.

Published MDMbox images support Linux amd64 and arm64:

TagWhat it selects
latestThe newest published version, including its updates. Moves forward as new versions are released.
YYMM, for example 2609A selected monthly version, including its updates.
YYMM.N, for example 2609.0An exact published release. This tag does not move.
edgeA development build. Use a released monthly version for production.

For a local trial, use healthsamurai/mdmbox:latest together with healthsamurai/aidboxone:latest, as in Getting started. To stay on selected monthly versions, replace latest in each service's image value with its monthly tag, keeping Aidbox within the supported range. Use exact YYMM.N tags when you want to select each update explicitly.

Shared configuration

MDMbox and Aidbox run as separate services connected to the same PostgreSQL database. Use PostgreSQL 14 or later and pass the same BOX_DB_* and relevant BOX_FHIR_* settings to both services.

Set the same BOX_WEB_BASE_URL in both services to the public Aidbox address reachable by users and API clients. The local Docker Compose example uses http://localhost:8888. See Configuration reference for MDMbox settings and Aidbox's settings reference for the shared settings.

Next steps

Last updated: