Mifos X Platform 23.12.31 - Installation Instructions using Docker Compose on Linux Ubuntu 22.04
- Victor Romero
System, these instructions should ideally be executed by users with basic technical skills.
Target Audience
Username | User description |
General Public | User should have basic knowledge about Linux commands. |
|
|
System requirements
Hardware:
|
Software:
|
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.
Instructions
| |
Go to Docker Download Web Page and select the version for Ubuntu. | |
|  |
Run the following command to uninstall all conflicting packages | |
We update the package list
sudo apt-get update | |
We install the certificates
sudo apt-get install ca-certificates curl | |
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 | |
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 | |
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 | |
Update the package list again
| |
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 | |
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 | |
Linux post-installation steps for Docker Engine | |
| |
Create the docker group. | |
Add your user to the docker group. | |
Validate that docker is installed.
docker info
Note: if the docker information is not displayed, log out and validate again | |
| |
When you enter the download link, the file will automatically start downloading | |
We locate the downloaded zip file | |
Enter the path where the Zip file is located | |
We unzip the downloaded zip file.
unzip mifosplatform-23.12.31.RELEASE.zip | |
| |
Enter the mariadb folder cd ./mifosplatform-23.12.31.RELEASE/docker/mifosx-mariadb | |
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 | |
Validate that containers are lifted correctly: | |
Validate that Mifos X Release 23.12 is up and running entering the following url http://localhost in a Web Browser | |
Sign in with the default credentials:
User: mifos
Password: password
If you require some help please contact us. These are the channels available to get in contact: Communications Please include screens, logs (use a paste tool like Encrypted note on PrivateBin ), description of the issue with all the details that you can share. Please be careful and avoid to include sensitive data. Remember that these installation instructions are for a quick way to get the Mifos X Platform up and running very quickly. You have to protect the sensitive data in motion/rest, secrets, connections, credentials, etc. based on your local requirements. | |