Versions Compared

Key

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

System, these instructions should ideally be executed by users with basic technical skills.

  1. Target Audience

Username

User description

General Public

User should have basic knowledge about Linux commands.

  1. System requirements

Hardware:

  • 8Gb RAM 

  • 2 vCPUs (Intel x86 64bits or AMD x86 64bits)

  • 32Gb Storage 

Software:

  • Linux Ubuntu 22.04 LTS 64 bits Operating System

  • Docker 25.03

  1. Deployment Architecture

This is a graphical representation of the components that will be installed, they are highlighted in yellow, and the others put in the graphic as a reference and they can be used for extending the functionality.

  1. Instructions

  1. Install Docker 

Go to Docker Download Web Page and select the version for  Ubuntu. 

https://docs.docker.com/engine/install/ubuntu/ 

Image Modified

Run the following command to uninstall all conflicting packages

Image Modified

We update the package list

sudo apt-get update

Image Modified

We install the certificates

sudo apt-get install ca-certificates curl

Image Modified

We enter the keys.

sudo install -m 0755 -d /etc/apt/keyrings

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

Image Modified

Entering the command grants read, write, and execute permissions to the owner, and read and execute permissions to the group and others.

sudo chmod a+r /etc/apt/keyrings/docker.asc

Image Modified

Add the repository to Apt sources

echo \

  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \

  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \

  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Image Modified

Update the package list again

Image Modified

Install the Docker packages.

To install the latest version, run:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Image Modified

Verify that the Docker Engine installation is successful by running the hello-world image.

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Image Modified

Linux post-installation steps for Docker Engine

https://docs.docker.com/engine/install/linux-postinstall/ 

Image Modified

Create the docker group.

Image Modified

Add your user to the docker group.

Image Modified

Validate that docker is installed.

docker info

Note: if the docker information is not displayed, log out and validate again

Image Modified

  1. Download zip file from SourceForge https://sourceforge.net/projects/mifos/files/Mifos%20X/mifosplatform-23.12.31.RELEASE.zip/download 

When you enter the download link, the file will automatically start downloading

Image Modified

We locate the downloaded zip file

Image Modified

Enter the path where the Zip file is located

Image Modified

We unzip the downloaded zip file.

unzip mifosplatform-23.12.31.RELEASE.zip

Image Modified

  1. We start the configuration to start the containers in docker.

Enter the mariadb folder

cd ./mifosplatform-23.12.31.RELEASE/docker/mifosx-mariadb

Image Modified

once in the path and in the folder, we raise the docker compose containers with the command, 

docker compose pull && docker compose down && docker compose up -d && docker compose logs -f

Image Modified

Validate that containers are lifted correctly:

Image Modified

Validate that Mifos X Release 23.12 is up and running entering the following url  http://localhostin a Web Browser

Image Modified

Sign in with the default credentials:

User: mifos

Password: password

Image Modified