In order to install the modular openIMIS using Docker, you first need to install Docker Desktop. Please download and install the platform from the Docker Desktop website.
First startup
The first startup is special since it will create the necessary docker images and containers to run openIMIS. To build necessary, docker images, docker-compose relies on local docker files. In order to build these images, you need to clone, next to openimis-dist_dkr/
the following Github repository:
openimis-db_dkr
openimis-be_py
openimis-fe_js
openimis-gateway_dkr
From within openimis-dist_dkr/
directory:
create a
.env
file, providing the following variables:
#DB_SQL_SCRIPT=<URL pointing to the SQL script> #ACCEPT_EULA=<must put Y but it means you accept Microsoft EULA for the MSSQL database container> DB_HOST=<your database host, or db to use the demo docker 'db' service> DB_PORT=<your database port on the host, 1433 if you use the demo docker 'db' service> DB_NAME=<your database name, imis if you use the demo docker 'db' service> DB_USER=<your database user, sa if you use the demo docker 'db' service > DB_PASSWORD=<your database password, generate one if you use the demo docker 'db' service> NEW_OPENIMIS_HOST=<(sub)domain under which the (new) openIMIS will be served (e.g. openimis.domaine) > LEGACY_OPENIMIS_HOST=<(sub)domain under which legacy openIMIS is served (e.g. demo.openimis.org) >
If you use the demo docker 'db' service:
choose the SQL script to create/restore the database. Reference models are provided in database_ms_sqlserver Github. Example:
Empty database:
https://github.com/openimis/database_ms_sqlserver/raw/master/Empty%20databases/openIMIS_ONLINE.sql
Demo database:
https://github.com/openimis/database_ms_sqlserver/raw/develop/Demo%20database/openIMIS_demo_1.3.0.sql
build and start the database docker image:
docker-compose up db
(note: use --force-recreate if you already created the image but want to change the password)create the imis database into the container:
docker container ls
and spot the line (CONTAINER ID) withopenimis-db
IMAGE namedocker exec <CONTAINER ID> /create_database.sh
build and start the gateway (and backend) docker image:
docker-compose up gateway
(note: at each start, openIMIS will apply the necessary database migrations to update the database scheme)register a letsencrypt certificate for your openIMIS gateway
list running containers and spot the gateway:
docker container ls
(the gateway should be namedopenimis-gateway
)connect to the gateway:
docker exec -it <CONTAINER ID> /bin/sh
(sh and not bash)issue the command
install-certificate.sh
... and follow the setup wizzard (provide contact address,
register your openIMIS superuser in the gateway:
list running containers and spot the gateway:
docker container ls
(the gateway should be namedopenimis-gateway
)connect to the gateway:
docker exec -it <CONTAINER ID> /bin/sh
(sh and not bash)you should be in /script directory, if not, just
cd /script
)in the gateway container, register your openIMIS superuser:
./add-user.sh <SUPERUSER_NAME> <SUPER_USER_PASSWORD>
Notes:same procedure (add-user.sh) must be followed to add external applications accesses
in
/script
, there are alsoremove-user.sh
andupdate-user.sh
If connecting to brand new database, register your openIMIS superuser:
list running containers and spot the backend:
docker container ls
(the gateway should be namedopenimis-backend
)connect to the gateway:
docker exec -it <CONTAINER ID> /bin/bash
(bash and not sh this time)you should be in /openimis-be/openIMIS directory, if not, just
cd /openimis-be/openIMIS
)register your openIMIS superuser:
python manage.py createsuperuser
(and follow instructions)
stop /start
From within openimis-dist_dkr/
directory: To stop all docker containers: docker-compose stop
To (re-)start all docker containers: docker-compose start