This guide is valid for the installation of the new openIMIS version together with the REST API component. 0. PrerequisiteTo install openIMIS using Docker, you first need first to install Docker on your computer/server. Please visit https://docs.docker.com/get-docker/ website to download and install the version that matches your OS. 1. Download openIMIS Docker scriptClone the https://github.com/openimis/openimis-dist_dkr on your machine into a new folder. 2. First startupCreate the .env file from the .env.example and configure the environment variables according to the comments in the file. By default, PostgreSQL database is used. On the same level as openimis-dist_dkr directory, there should be a conf directory that is used for storing instance-specific configuration that will be reused if the docker containers are restarted If you use the demo docker 'db' service: Build and start the docker compose: docker-compose up -d If you prefer to use Microsoft SQL Server database: docker-compose -f docker-compose-mssql.yml up -d Accept the Microsoft EULA (set the value of ACCEPT_EULA to Y , not required for PGSQL)then run those command in that order to make sure the coreMIS part is properly configured Code Block |
---|
docker compose up -d db
#wait for the db to be initialised
sleep 180
#load the .env file in your shell to have the access to the env variables
source .env
source .env.lightning
# create the lightning database
docker compose run -e PGPASSWORD=${POSTGRES_PASSWORD} --rm db createdb -h db -U ${POSTGRES_USER} ${POSTGRES_DB}
set -e
# init lighning
docker compose run --rm web mix ecto.migrate
docker compose run --rm web mix run imisSetupScripts/imisSetup.exs
#start all modules
docker compose up -d
#load opensearch dashbaord
docker compose run --rm -e MODE=DEV backend manage upload_opensearch_dashboards --host-domain https://demo.openimis.org --imis-password admin123 |
3. SSL certificate / httpsthere is a docker-compose that support let’s encrypt certificates first export NEW_OPENIMIS_HOST , dry run docker-compose run --rm --entrypoint " certbot certonly --webroot -w /var/www/certbot --staging --register-unsafely-without-email -d ${NEW_OPENIMIS_HOST} --rsa-key-size 2048 --agree-tos --force-renewal" certbot actual setupdocker-compose run --rm --entrypoint " certbot certonly --webroot -w /var/www/certbot --register-unsafely-without-email -d ${NEW_OPENIMIS_HOST} --rsa-key-size 2048 --agree-tos --force-renewal" certbot 4. ActionsFrom within openimis-dist_dkr/windows directory: To stop all docker containers: docker-compose stop To (re-)start all docker containers: docker-compose start To pull new images or images update `docker-compose pull`
|