The MIH Project

learn how to create your own flavour of the MIH Server.

Prerequisite:-

  1. Ubuntu Server OS installed (24.04 tested)
  2. Docker is Installed.
  3. Git is Installed.
  4. Sudo permission granted.

Get Started:-

  1. Clone Git Repo.
  2. Navigate to Mzansi-Innovation-Hub directory. 
    cd Mzansi-Innovation-Hub
  3. Create .env file in the same location as docker-compose.yml
    
SQL_ROOT_PW=*PASSWORD*
SQL_USER=*USER*
SQL_USER_PW=*PASSWORD*

SUPERTOKENS_DB=supertokens
SUPERTOKENS_API_KEY=*API KEY*

MINIO_ROOT_USER=*USER*
MINIO_ROOT_PW=*PASSWORD*

CERTBOT_EMAIL=*ADMIN_EMAIL*
CERTBOT_APP_DOMAIN=*APP_DOMAIN*
CERTBOT_API_DOMAIN=*API_DOMAIN*
CERTBOT_STORAGE_DOMAIN=*STORAGE_DOMAIN*
CERTBOT_MONITOR_DOMAIN=*MONITOR_DOMAIN*
CERTBOT_AI_DOMAIN=*AI_DOMAIN*
  4. Configure MIH-AI.
    1. If your server hardware has an Nvidia GPU, follow the instructions below "How to enable MIH-AI GPU usage"
    2. If your server hardware does not use an Nvidia GPU, continue with the next step.
  5. Start MIH Server.
    1. Non-Prod: 
      sudo docker compose up -d --build
    2. Prod: 
      sudo docker compose --profile prod up -d --build
    3. Prod with Letsincrypt certificate Generation: 
      sudo docker compose --profile prod --profile withCert up -d --build
  6. Check the status of the new MIH server using Portainer. https://localhost:9443/ (Change Local Host to IP if necessary).
    1. If all containers are running without errors, proceed to step 5
      (NOTE: certbot container will stop after running successfully).
    2. If MIH-Minio did not start correctly, run sudo chown 1001 File_Storage/ in the project directory, stop MIH Server (see details below), then start MIH Server again. 
      sudo chown 1001 File_Storage
  7. Set Up MIH-Minio config
    1. Access MIH-Minio using https://localhost:9001/login (Change Localhost to IP if necessary).
    2. Add/ Generate access key to MIH-Minio.
    3. Create a bucket called mih.
    4. Non-Prod: make the mih bucket public.
    5. Prod: keep the mih bucket private.

How to Stop MIH Server:-

  1. Non-Prod: disables Nginx & CertBot container creation.
    sudo docker compose down
  2. Prod: 
    sudo docker compose --profile prod down
  3. Prod with Letsincrypt certificate Generation: 
    sudo docker compose --profile prod --profile withCert down

How to enable MIH-AI GPU:-

  1. Uncomment the code block in MIH-AI docker-compose.yaml 
    
# deploy:
    
#   resources:
    
#     reservations:
    
#       devices:
    
#         - driver: nvidia
    
#           count: all # or specify a number of GPUs
    
#           capabilities: [gpu]