Updating MDMbox

Choose image tags using Versions and compatibility, and check Release notes for changes affecting your integration.

Docker Compose

From the directory containing the docker-compose.yml used in Getting started, run:

docker compose pull
docker compose up -d

With latest, this updates both services to their latest releases. With a monthly tag, it updates within that series. To change monthly versions, edit the services' image values before running these commands. Keep Aidbox within MDMbox's supported range.

To stop the local environment:

docker compose down

This keeps the database volume, including your records, matching models, and operation history.

Kubernetes

Update the image configuration in values.yaml and apply it with the same Helm command used for installation:

helm upgrade --install mdmbox healthsamurai/mdmbox \
  --namespace aidbox \
  --values values.yaml

When updating within the same monthly tag, Helm may have no pod configuration change to apply. With image.pullPolicy: Always from the installation example, restart the deployment to pull the updated image:

kubectl rollout restart deployment/mdmbox --namespace aidbox
kubectl rollout status deployment/mdmbox --namespace aidbox

When using continuous matching, follow its deployment and upgrade guidance for process recovery, compatible model versions, and connection capacity during replacement.