(22.10) Installation Test: openIMIS on Windows 10 with Docker Desktop

Contents

• Test Information

• Technical specifications

• Activity log

  • Install Git for Windows (if no other GIT implementation is already installed)

  • Install Docker Desktop

  • Build the openIMIS Docker Container

  • Download and build openIMIS Docker Container

• Results

• Observations/Lessons Learned

Test Information

Technical specifications

Activity log

Install Git for Windows (if no other GIT implementation is already installed)

1. Install Git for Windows

   winget install --id "Git.Git"

2. Follow the instructions of the installer

Install Docker Desktop

1. Install Docker Desktop

   winget install --id "Docker.DockerDesktop"

2. Start Docker Desktop

3. Follow the instruction when asked to download install WSL 2

4. Restart Docker Desktop after installing the WSL 2 update - If an error occurs choose to “Quit” Docker Desktop and start it again

5. Make sure that Docker Desktop is up and running

Build the openIMIS Docker Container

Download and build openIMIS Docker Container

1. Create a working folder on your hard disk

2. Clone the openIMIS Docker script in your working folder

   git clone https://github.com/openimis/openimis-dist_dkr

3. Change in the created folder

4. Create a copy of “.env.example” and name it “.env”

5. Make necessary configuration changes in “.env” or leave defaults for a demo instance of openIMIS

6. Build Docker images (this will download some necessary components, the process will take approximately 20-30 minutes or more depending on your configuration, hardware and network connectivity)

   docker-compose build

   1. As the process depends on a multitude of external sources temporary problems might occur, in that case simply restart the build process at a later time until it is able to finish re

7. Build and start the container (this will download further necessary components)

   docker-compose up

8. Wait for the process to finish setting up the (demo) instances

Results

Test was a success and openIMIS can be started:

• Now you can access your local instance of openIMIS under https://localhost/front

• Login with the default user & passwort: Admin // admin123

• Don’t forget to change it (Profile\Change Password)

Observations/Lessons Learned

(N/A)