How to create your 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]