Links

Migrate from Multibox to Aidbox

This guide shows you how to migrate from Multibox instance to few Aidbox instances
Let's say you have Multibox deployed locally by Run Multibox locally getting started guide. And you have couple of boxes launched there.
  • fhirr4box box with FHIR R4 version
  • fhirr5box box with FHIR R5 version
To migrate them to Aidbox instance, you need to issue an Aidbox license for each box in multibox.
Stop Multibox instance
docker compose stop multibox

Docker compose file

Add two new Aidbox instances to docker compose file
version: '3.7'
services:
aidbox-db:
image: "${PGIMAGE}"
ports:
- "${PGHOSTPORT}:${PGPORT}"
volumes:
- "./pgdata:/data"
environment:
POSTGRES_USER: "${PGUSER}"
POSTGRES_PASSWORD: "${PGPASSWORD}"
POSTGRES_DB: "${PGDATABASE}"
multibox:
image: "${AIDBOX_IMAGE}"
pull_policy: always
depends_on: ["aidbox-db"]
links:
- "aidbox-db:database"
ports:
- "${AIDBOX_PORT}:${AIDBOX_PORT}"
env_file:
- .env
environment:
PGHOST: database
fhirr4box:
image: healthsamurai/aidboxone:edge
pull_policy: always
depends_on: ["aidbox-db"]
ports:
- "8888:${AIDBOX_PORT}"
env_file:
- .env
environment:
AIDBOX_LICENSE: <license-for-fhirr4box>
AIDBOX_FHIR_VERSION: "4.0.1"
PGDATABASE: fhirr4box
PGPORT: 5432
PGHOST: aidbox-db
fhirr5box:
image: healthsamurai/aidboxone:edge
pull_policy: always
depends_on: ["aidbox-db"]
ports:
- "9999:${AIDBOX_PORT}"
env_file:
- .env
environment:
AIDBOX_LICENSE: <license-for-fhirr5box>
AIDBOX_FHIR_VERSION: "5.0.0"
PGDATABASE: fhirr5box
PGPORT: 5432
PGHOST: aidbox-db
If you use Aidbox configuration project, you should also pass BOX_PROJECT_GIT_TARGET__PATH and AIDBOX_ZEN_ENTRYPOINT.

.env file

As we specified AIDBOX_LICENSE, AIDBOX_FHIR_VERSION and PGDATABASE for every Aidbox instance, we should remove it from .env file.
Multibox requires AIDBOX_SUPERUSER env variable to be set. Aidbox instance creates admin user and root client resources at startup, and expects 4 env variables instead of one AIDBOX_SUPERUSER:
AIDBOX_ADMIN_ID=admin
AIDBOX_ADMIN_PASSWORD=password
AIDBOX_CLIENT_ID=root
AIDBOX_CLIENT_SECRET=secret
# not needed envs by Aidbox
# AIDBOX_SUPERUSER=...
# AIDBOX_LICENSE=...
# AIDBOX_FHIR_VERSION=...
# PGDATABASE=...

Run Aidbox instances

Now you can run your aidbox instances
docker compose up -d fhirr4box fhirr5box
fhirr4box will be accessible on http://localhost:8888, and fhirr5box will be accessible on http://localhost:9999.

Talk to a Health Samurai Engineer

If you'd like to learn more about using Aidbox or have any questions about this guide, connect with us on Telegram. We're happy to help.
Last modified 5mo ago