Run Multibox locally with Docker
This quickstart guide explains how to run Multibox locally using docker compose. You will learn how to obtain a free short-time license and set up Multibox.
You'll see your license in the "My Licenses" list. Click on your new license and copy credentials. It is a long string like
eyJhbGciOiJ...
This string is your license key.
Firstly, let's make the configuration file. There are two services:
aidbox-db
and multibox
. The first one is PostgreSQL database and the second one is the Multibox itself.docker-compose.yaml
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
To configure Multibox we need to pass environment variables to it. We can pass them with
.env
file..env
# postgres image to run
PGIMAGE=healthsamurai/aidboxdb:14.2
# aidbox image to run
# AIDBOX_IMAGE=healthsamurai/aidboxone:stable
AIDBOX_IMAGE=healthsamurai/multibox:edge
# license details
AIDBOX_LICENSE=<your-license-key>
# if you got pair of id and key use this instead
# AIDBOX_LICENSE_ID=<your-license-id>
# AIDBOX_LICENSE_KEY=<your-license-key>
# port to run webserver at
AIDBOX_PORT=8888
AIDBOX_FHIR_VERSION=4.0.1
# db connection params
PGPORT=5432
PGHOSTPORT=5437
PGUSER=postgres
PGPASSWORD=postgres
PGDATABASE=aidbox
AIDBOX_CLUSTER_SECRET=secret
AIDBOX_CLUSTER_DOMAIN=127.0.0.1.nip.io
AIDBOX_SUPERUSER=admin:secret
AIDBOX_BASE_URL=http://${AIDBOX_CLUSTER_DOMAIN}:${AIDBOX_PORT}
AIDBOX_COMPLIANCE=enabled
Insert your license key into environment file. Change the line
AIDBOX_LICENSE=<your-license-key>
in the
.env
file where <your-license-key>
is a license key which you obtained on the get a license step.Start Multibox with Docker Compose
docker compose up --force-recreate
This command will download and start Multibox and its dependencies. This can take a few minutes.
Open http://127.0.0.1.nip.io:8888. You'll see Multibox login page. Sign in using credentials specified in
AIDBOX_SUPERUSER
variable in .env
file.Now you are ready to use Multibox.
Last modified 1mo ago