Versions Compared

Old Version 2

changes.mady.by.user Marco Kalin

Saved on

compared with

New Version 3

changes.mady.by.user Marco Kalin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Tested version Release 2022-10

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

Preparation

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

  1. Install Git for Windows

    Code Block
    winget install --id "Git.Git"

  2. Follow the instructions of the installer

Install Docker Desktop

  1. Install Docker Desktop

    Code Block
    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

    Code Block
     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)

    Code Block
    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)

    Code Block
    docker-compose up

  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)