Tested versions:

• Release 2022-10

• Release 2023-04

Preconditions

• Windows 10 or 11

• Minimum of 15 GB free space on hard disk

• Minimum of 8 GB RAM

• Access to PowerShell and administrative rights

• 3-4 GB Data plan volume

Preparation

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)

   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)

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

Start openIMIS

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

2. Login with the default user & passwort: Admin // admin123

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