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: https://mifos.org/resources/community/communications/ Please include screens, logs (use a paste tool like https://privatebin.net/ ), 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. | |