Update OctoJoom version and improve password validation #10

The OctoJoom version was updated to 3.6.2. Changes were also made to the password validation process to increase the minimum required length of the password from 4 to 11 characters for the correct error message.

src/octojoom

@@ -1,8 +1,11 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # The most recent program version.
-_VERSION="3.5.0"
-_V="3.5"
+_VERSION="3.6.2"
+_V="3.6"
+
+# Bash version required
+_bash_v=4
 
 # The program full name
 PROGRAM_NAME="Octojoom"
@@ -13,75 +16,216 @@ SERVER_HOSTNAME="$(hostname)"
 # Set the back title
 BACK_TITLE="    Octoleo | ${USER}@${SERVER_HOSTNAME}"
 
-# make sure whiptail is installed
-command -v whiptail >/dev/null 2>&1 || {
-  echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require whiptail."
-  exit 1
-}
+#####################################################################################################################VDM
+######################################## The environment preparation
 # make sure curl is installed
 command -v curl >/dev/null 2>&1 || {
   echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require curl."
+  echo >&2 "NOTICE: Please install curl first and then re-run this script again."
   exit 1
 }
+# Set OS number
+OS_NUMBER=0 # Unknown
+if [[ "$OSTYPE" == "linux-gnu"* ]]; then
+  OS_NUMBER=1
+elif [[ "$OSTYPE" == "darwin"* ]]; then
+  OS_NUMBER=2
+elif [[ "$OSTYPE" == "msys" || "$OSTYPE" == "cygwin" ]]; then
+  OS_NUMBER=3
+fi
+# Check Bash version
+function check_bash_version() {
+  local bash_version="$1"
+  local version_string="$BASH_VERSION"
+  local major_version="${version_string%%.*}"
+  local rest="${version_string#*.}"
+  local minor_version="${rest%%.*}"
+
+  if (( major_version < bash_version )) || (( major_version == bash_version && minor_version < 0 )); then
+    echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script requires Bash version ${bash_version}.0 or above."
+    exit 1
+  fi
+}
+# Check for the appropriate version of Bash
+check_bash_version "$_bash_v"
+# Install whiptail on Ubuntu
+function install_whiptail_linux() {
+  sudo apt-get update
+  sudo apt-get install whiptail -y
+}
+# Install whiptail on macOS
+function install_whiptail_macos() {
+  if ! command -v brew >/dev/null 2>&1; then
+    echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require Homebrew to install whiptail on macOS."
+    echo >&2 "NOTICE: Please install Homebrew first and then re-run this script."
+    exit 1
+  fi
+  brew install newt
+}
+# Install whiptail on Windows using Chocolatey
+function install_whiptail_windows() {
+  if ! command -v choco >/dev/null 2>&1; then
+    echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require Chocolatey to install whiptail on Windows."
+    echo >&2 "NOTICE: Please install Chocolatey first and then re-run this script."
+    exit 1
+  fi
+  choco install newt
+}
+# Main script
+if ! command -v whiptail >/dev/null 2>&1; then
+  echo "Whiptail is not installed. Do you want to install it now? (y/n)"
+  read -r response
+  if [[ "$response" =~ ^[Yy]$ ]]; then
+    # If the user chooses Yes, install Docker based on the OS
+    case "$OS_NUMBER" in
+      1)
+        install_whiptail_linux
+        ;;
+      2)
+        install_whiptail_macos
+        ;;
+      3)
+        install_whiptail_windows
+        ;;
+      *)
+        echo >&2 "ERROR: Unsupported operating system."
+        exit 1
+        ;;
+    esac
+  else
+    echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require whiptail."
+    echo >&2 "NOTICE: Please install whiptail first and then re-run this script again."
+    exit 1
+  fi
+fi
 # make sure awk is installed
 command -v awk >/dev/null 2>&1 || {
   echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require awk."
+  echo >&2 "NOTICE: Please install awk first and then re-run this script again."
   exit 1
 }
-# Check if Docker is installed.
-if ! command -v docker &>/dev/null; then
-  # If Docker is not installed, ask the user if they want to install it.
-  if whiptail --yesno "Docker is not installed. Do you want to install it now?" \
-    --backtitle "${BACK_TITLE}" 10 60; then
-    # If the user chooses Yes, install Docker.
-    echo "Installing Docker..."
-
+# make sure rsync is installed (hmmm not always)
+#command -v rsync >/dev/null 2>&1 || {
+#  echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require rsync."
+#  exit 1
+#}
+# Check and install Docker on Linux
+function install_docker_linux() {
+  echo "Installing Docker on Linux..."
  # Add Docker GPG key and repository to sources.list.
   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
   echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
-
   # Update package index and install Docker.
   sudo apt-get update
   sudo apt-get install docker-ce docker-ce-cli containerd.io -y
-
   # Add the current user to the docker group.
   sudo groupadd docker
   sudo usermod -aG docker "$USER"
-
   # Enable and start the Docker service.
   sudo systemctl enable docker.service
   sudo systemctl start docker.service
-
   echo "Docker is installed."
+}
+# Check and install Docker on macOS
+function install_docker_macos() {
+  echo "Installing Docker on macOS..."
+  brew install --cask docker
+  open /Applications/Docker.app
+  echo "Docker is installed. Please follow the prompts to complete the installation."
+}
+# Check and install Docker on Windows (MSYS/Cygwin)
+function install_docker_windows() {
+  echo "Please download and install Docker Desktop from https://www.docker.com/products/docker-desktop"
+  echo "Docker Desktop is required for Windows environments."
+  exit 0
+}
+# Check if Docker is installed
+if ! command -v docker &>/dev/null; then
+  # If Docker is not installed, ask the user if they want to install it
+  if whiptail --yesno "Docker is not installed. Do you want to install it now?" \
+      --backtitle "${BACK_TITLE}" 10 60; then
+    # If the user chooses Yes, install Docker based on the OS
+    case "$OS_NUMBER" in
+      1)
+        install_docker_linux
+        ;;
+      2)
+        install_docker_macos
+        ;;
+      3)
+        install_docker_windows
+        ;;
+      *)
+        echo >&2 "ERROR: Unsupported operating system."
+        exit 1
+        ;;
+    esac
   else
-    # If the user chooses No, exit the script with an error message.
-    echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require docker."
+    # If the user chooses No, exit the script with an error message
+    echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script requires Docker."
+    echo >&2 "NOTICE: Please install Docker first and then re-run this script again."
     exit 1
   fi
 fi
-# Check if Docker Compose is installed.
-if ! command -v docker-compose &>/dev/null; then
-  # If Docker Compose is not installed, ask the user if they want to install it.
-  if whiptail --yesno "Docker Compose is not installed. Do you want to install it now?" \
-    --backtitle "${BACK_TITLE}" 10 60; then
-    # If the user chooses Yes, install Docker Compose.
-    echo "Installing Docker Compose..."
-
+# Install Docker Compose on Linux
+function install_docker_compose_linux() {
+  echo "Installing Docker Compose on Linux..."
   # Download the latest Docker Compose binary.
   COMPOSE_VERSION=$(curl --silent https://api.github.com/repos/docker/compose/releases/latest | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')
   sudo curl -SL "https://github.com/docker/compose/releases/download/$COMPOSE_VERSION/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
-
   # Make the Docker Compose binary executable.
   sudo chmod +x /usr/local/bin/docker-compose
   sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
-
   echo "Docker Compose is installed."
+}
+# Install Docker Compose on macOS
+function install_docker_compose_macos() {
+  echo "Installing Docker Compose on macOS..."
+  # Download the latest Docker Compose binary.
+  COMPOSE_VERSION=$(curl --silent https://api.github.com/repos/docker/compose/releases/latest | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')
+  sudo curl -SL "https://github.com/docker/compose/releases/download/$COMPOSE_VERSION/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+  # Make the Docker Compose binary executable.
+  sudo chmod +x /usr/local/bin/docker-compose
+  sudo ln -s /usr/local/bin/docker-compose /usr/local/bin/docker-compose
+  echo "Docker Compose is installed."
+}
+# Install Docker Compose on Windows (MSYS/Cygwin)
+function install_docker_compose_windows() {
+  echo "Please download Docker Compose from https://github.com/docker/compose/releases"
+  echo "and place it in a directory included in your PATH."
+  exit 0
+}
+# Check if Docker Compose is installed
+if ! command -v docker-compose &>/dev/null; then
+  # If Docker Compose is not installed, ask the user if they want to install it
+  if whiptail --yesno "Docker Compose is not installed. Do you want to install it now?" \
+        --backtitle "${BACK_TITLE}" 10 60; then
+    # If the user chooses Yes, install Docker Compose based on the OS
+    case "$OS_NUMBER" in
+      1)
+        install_docker_compose_linux
+        ;;
+      2)
+        install_docker_compose_macos
+        ;;
+      3)
+        install_docker_compose_windows
+        ;;
+      *)
+        echo >&2 "ERROR: Unsupported operating system."
+        exit 1
+        ;;
+    esac
   else
-    # If the user chooses No, exit the script with an error message.
-    echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script require docker-compose."
+    # If the user chooses No, exit the script with an error message
+    echo >&2 "ERROR: ${PROGRAM_NAME} v${_VERSION} script requires docker-compose."
+    echo >&2 "NOTICE: Please install docker-compose first and then re-run this script again."
     exit 1
   fi
 fi
+# Setting the LC_ALL with respect to language, regional settings, to use POSIX locale,
+# so ASCII character set and standardizes behavior is used for consistent across different environments
+export LC_ALL=C
 # just clear the screen
 clear
 
@@ -170,15 +314,13 @@ function traefik__TRuST__setup() {
 function traefikContainer() {
   # we build the yml file
   cat <<EOF
-version: "3.3"
-
 services:
   traefik:
     container_name: traefik
     image: "traefik:latest"
     command:
-${VDM_REMOVE_SECURE}      - --entrypoints.web.address=:80
-${VDM_REMOVE_SECURE}      - --entrypoints.websecure.address=:443
+      - --entrypoints.web.address=:80
+      - --entrypoints.websecure.address=:443
 #      - --api.dashboard=true
 #      - --api.insecure=true
       - --providers.docker
@@ -211,6 +353,7 @@ ${VDM_REMOVE_SECURE}      - "traefik.http.middlewares.redirect-to-me.redirectsch
 
 networks:
   traefik:
+    external: true
     name: ${VDM_TRAEFIK_GATEWAY:-traefik_webgateway}
 EOF
 }
@@ -284,8 +427,6 @@ function portainer__TRuST__setup() {
 function portainerContainer() {
   # we build the yml file
   cat <<EOF
-version: "3.3"
-
 services:
   portainer:
     image: portainer/portainer-ce:latest
@@ -640,7 +781,6 @@ function joomlaContainer() {
   fi
   # we build the yml file
   cat <<EOF
-version: '2'
 services:
   mariadb${VDM_KEY}:
     image: mariadb:latest
@@ -1225,7 +1365,6 @@ function openssh__TRuST__setup() {
 function opensshContainer() {
   # we build the yml file
   cat <<EOF
-version: "2.1"
 services:
   openssh-server-${VDM_KEY}:
     image: lscr.io/linuxserver/openssh-server
@@ -1247,6 +1386,7 @@ services:
 
 networks:
   openssh:
+    external: true
     name: ${VDM_OPENSSH_GATEWAY:-openssh_gateway}
 EOF
 }
@@ -1894,6 +2034,18 @@ function portainer__TRuST__delete() {
   fi
 }
 
+#####################################################################################################################VDM
+######################################## RESET JOOMLA
+function joomla__TRuST__reset() {
+  # ask if there are volumes to delete
+  if hasDirectories '' "${VDM_PROJECT_PATH}" &&
+    (whiptail --yesno "Would you like to reset persistent volumes found in (${VDM_PROJECT_PATH})?" \
+      --title "Continue To Reset Persistent Volumes" --backtitle "${BACK_TITLE}" 12 112); then
+    # trigger the volumes reset script
+    resetPersistentJoomlaVolumes
+  fi
+}
+
 #####################################################################################################################VDM
 ######################################## Migrate Joomla
 function joomla__TRuST__migrate() {
@@ -2089,6 +2241,15 @@ function deleteContainer() {
   main
 }
 
+# reset a container
+function resetContainer() {
+  # make sure of our container type
+  VDM_CONTAINER_TYPE="${1}"
+  VDM_TASK="reset"
+  # execute the task
+  main
+}
+
 # migrate a container
 function migrateContainer() {
   # make sure of our container type
@@ -2286,6 +2447,47 @@ function deletePersistentVolumes() {
   fi
 }
 
+# reset persistent Joomla volume
+function resetPersistentJoomlaVolumes() {
+  # we first check if we have some volumes
+  if hasDirectories '' "${VDM_PROJECT_PATH}"; then
+    # set some local variables
+    local vdm_reset_volumes
+    local persistent
+    # saved the file
+    showNotice "Only reset persistent Joomla volumes of which you have made absolutely sure it's no longer in use!"
+    # get containers to enable
+    vdm_reset_volumes=$(getSelectedDirectories "Select persistent volume\s to reset." \
+      "${VDM_PROJECT_PATH}" "Select Persistent Volume\s to Reset")
+    # check that we have something, else return to main menu
+    if [ ${#vdm_reset_volumes} -ge 1 ]; then
+      # convert the string to and array
+      IFS=' ' read -r -a vdm_reset_volumes_array <<<"${vdm_reset_volumes[@]}"
+      # loop over the directories to build the
+      for volumes in "${vdm_reset_volumes_array[@]}"; do
+        # remove the " from the string
+        persistent="${volumes//\"/}"
+        # last serious check and then its gone
+        if [ -d "${VDM_PROJECT_PATH}/${persistent}/joomla" ] &&
+          (whiptail --yesno "Are you absolutely sure you would like to delete this (${persistent}/joomla) persistent volume? THIS CAN'T BE UNDONE!\n(we need sudo privileges)" \
+            --title "Delete Persistent Volume" --backtitle "${BACK_TITLE}" 15 112); then
+          # then remove soft link
+          sudo rm -rf "${VDM_PROJECT_PATH}/${persistent}/joomla"
+        fi
+        # last serious check and then its gone
+        if [ -d "${VDM_PROJECT_PATH}/${persistent}/db" ] &&
+          (whiptail --yesno "Are you absolutely sure you would like to delete this (${persistent}/db) persistent volume? THIS CAN'T BE UNDONE!\n(we need sudo privileges)" \
+            --title "Delete Persistent Volume" --backtitle "${BACK_TITLE}" 15 112); then
+          # then remove soft link
+          sudo rm -rf "${VDM_PROJECT_PATH}/${persistent}/db"
+        fi
+      done
+    fi
+  else
+    showError "There are no persistent volumes found in ${VDM_PROJECT_PATH}."
+  fi
+}
+
 # make an update
 function runUpdate() {
   # we need sudo permissions
@@ -2562,6 +2764,9 @@ function showJoomla() {
   # delete a container
   hasDirectories 'joomla/available' &&
     menu_options+=("delete" "Delete a container") && i=$((i + 1))
+  # reset a volume
+  isExpert && hasDirectories 'joomla/available' &&
+    menu_options+=("reset" "Reset a volume") && i=$((i + 1))
   # Get Joomla env details
   isExpert && hasDirectories 'joomla/available' &&
     menu_options+=("joomla_env" "Open Joomla .env Details") && i=$((i + 1))
@@ -2571,7 +2776,7 @@ function showJoomla() {
   menu_options+=("quit" "Quit ${PROGRAM_NAME}")
   # get the selection
   CHOICE=$(
-    whiptail --menu "Make your selection" 20 112 $i \
+    whiptail --menu "Make your selection" 23 112 $i \
       --title "Joomla | ${PROGRAM_NAME} v${_V}" --fb \
       --backtitle "${BACK_TITLE}" --nocancel --notags \
       "${menu_options[@]}" 3>&2 2>&1 1>&3
@@ -2603,6 +2808,9 @@ function showJoomla() {
   "delete")
     deleteContainer 'joomla'
     ;;
+  "reset")
+    resetContainer 'joomla'
+    ;;
   "joomla_env")
     openEnv 'joomla'
     ;;
@@ -2614,7 +2822,7 @@ function showJoomla() {
 
   # menu loop
   case $CHOICE in
-  "setup" | "edit" | "enable" | "disable" | "down" | "up" | "fix" | "delete" | "joomla_env" | "bulk")
+  "setup" | "edit" | "enable" | "disable" | "down" | "up" | "fix" | "delete" | "reset" | "joomla_env" | "bulk")
     showJoomla
     ;;
   esac
@@ -3857,7 +4065,7 @@ function setJoomlaPassword() {
       'joomla-17082005' 'Enter Joomla User Password')
     # keep asking if empty
     if [ ${#VDM_J_PASSWORD} -le 12 ]; then
-      showError "You must enter a password with more than 4 characters!"
+      showError "You must enter a password with more than 11 characters!"
     fi
   done
   # make sure it is available
@@ -4434,8 +4642,8 @@ function isFunc() {
   declare -F "$1" >/dev/null
 }
 
-# update the host file
-function updateHostFile() {
+# Update the host file for Linux and macOS
+function updateHostFile_unix() {
   # check if we should add to host file
   if allowEditHostFile; then
     # check if already in host file
@@ -4451,8 +4659,8 @@ function updateHostFile() {
   fi
 }
 
-# the manually edit the host file
-function editHostFile() {
+# Manually edit the host file for Linux and macOS
+function editHostFile_unix() {
   # check if we should add to host file
   if allowEditHostFile; then
     # if this container is enabled ask if it should be redeployed
@@ -4466,6 +4674,68 @@ function editHostFile() {
   fi
 }
 
+# Update the host file for Windows (MSYS/Cygwin)
+function updateHostFile_windows() {
+  local subdomain=${1:-$VDM_SUBDOMAIN}
+  local domain=${2:-$VDM_DOMAIN}
+  local host_file="/c/Windows/System32/drivers/etc/hosts"
+
+  if allowEditHostFile; then
+    if grep -q "${subdomain}.${domain}" "$host_file"; then
+      showNotice "${USER^}, ${subdomain}.${domain} is already in the hosts file."
+    elif (whiptail --yesno "${USER^}, to add the ${subdomain}.${domain} entry to your host file we need administrative privileges." \
+      --title "Give administrative Privileges" --backtitle "${BACK_TITLE}" 8 112); then
+      echo "127.0.0.1       ${subdomain}.${domain}" | sudo tee -a "$host_file" >/dev/null
+      showNotice "${USER^}, ${subdomain}.${domain} was added to the hosts file."
+    fi
+  fi
+}
+
+# Manually edit the host file for Windows (MSYS/Cygwin)
+function editHostFile_windows() {
+  local host_file="/c/Windows/System32/drivers/etc/hosts"
+
+  if allowEditHostFile; then
+    if (whiptail --yesno "To edit the host file we need administrative privileges.\n[Only continue if you know what you're doing!]" \
+      --title "Give administrative Privileges" --backtitle "${BACK_TITLE}" 15 112); then
+      showNotice "${USER^}, to save the changes you've made or to just close the file again press:\n\n[ctrl+x] with nano." 13
+      sudo "${EDITOR:-nano}" "$host_file"
+    fi
+  fi
+}
+
+# Update the host file (dynamically calls the correct OS function)
+function updateHostFile() {
+  case "$OS_NUMBER" in
+    1|2)
+      updateHostFile_unix "$@"
+      ;;
+    3)
+      updateHostFile_windows "$@"
+      ;;
+    *)
+      echo >&2 "ERROR: Unsupported operating system."
+      exit 1
+      ;;
+  esac
+}
+
+# Manually edit the host file (dynamically calls the correct OS function)
+function editHostFile() {
+  case "$OS_NUMBER" in
+    1|2)
+      editHostFile_unix
+      ;;
+    3)
+      editHostFile_windows
+      ;;
+    *)
+      echo >&2 "ERROR: Unsupported operating system."
+      exit 1
+      ;;
+  esac
+}
+
 # the manually edit the config file
 function editConfigFile() {
   # check if the file exist
@@ -4502,9 +4772,9 @@ function openEnv() {
 
 # Check if any hosts are set in the SSH config file
 function hasRemoteSystemSet() {
-  local ssh_config="/home/${USER}/.ssh/config"
+  local ssh_config="${VDM_HOME_PATH}/.ssh/config"
 
-  if [ ! -d "/home/${USER}/.ssh" ] || [ ! -f "${ssh_config}" ] ||
+  if [ ! -d "${VDM_HOME_PATH}/.ssh" ] || [ ! -f "${ssh_config}" ] ||
     [[ $(grep -i -c '^host' "${ssh_config}") -eq 0 ]]; then
       showError "To use this feature you must first set up the needed remote host details in (~/.ssh/config) to allow easy and secure SSH access."
       return 1
@@ -4518,7 +4788,7 @@ function getRemoteSystem() {
   # The selected folder
   local answer
 
-  if [ -f "/home/${USER}/.ssh/config" ]; then
+  if [ -f "${VDM_HOME_PATH}/.ssh/config" ]; then
     # We start the selection array
     local selected=()
     # Our counter
@@ -4531,7 +4801,7 @@ function getRemoteSystem() {
       if [ "$i" -le 10 ]; then
         i=$((i + 1))
       fi
-    done < <(grep -i '^host' "/home/${USER}/.ssh/config" | awk '{print $2}' | sort)
+    done < <(grep -i '^host' "${VDM_HOME_PATH}/.ssh/config" | awk '{print $2}' | sort)
 
     # Add manual input option
     selected+=("Enter manually" "Enter manually" "OFF")
@@ -4577,7 +4847,7 @@ function remoteEnvFileExists() {
 
   # Check if the file exists on the remote system
   # shellcheck disable=SC2029
-  ssh "${remote_system}" "[ -f \"/home/${USER}/.config/octojoom/.env\" ]"
+  ssh "${remote_system}" "[ -f \"${VDM_HOME_PATH}/.config/octojoom/.env\" ]"
 }
 
 # Get a specific value from the remote .env file
@@ -4588,7 +4858,7 @@ function getRemoteEnvValue() {
 
   if remoteEnvFileExists "${remote_system}"; then
     # shellcheck disable=SC2029
-    remote_env_value=$(ssh "${remote_system}" "grep '^${env_key}=' \"/home/${USER}/.config/octojoom/.env\"" | cut -d '=' -f 2-)
+    remote_env_value=$(ssh "${remote_system}" "grep '^${env_key}=' \"${VDM_HOME_PATH}/.config/octojoom/.env\"" | cut -d '=' -f 2-)
   fi
 
   # Remove any double quotes from the returned value
@@ -4861,8 +5131,8 @@ function moveTarToRemote() {
   local remote_path="$2"
   local remote="$3"
 
-  if [ -f "/home/${USER}/.ssh/config" ]; then
-    scp -F "/home/${USER}/.ssh/config" "${local_path}" "${remote}:${remote_path}"
+  if [ -f "${VDM_HOME_PATH}/.ssh/config" ]; then
+    scp -F "${VDM_HOME_PATH}/.ssh/config" "${local_path}" "${remote}:${remote_path}"
   else
     scp "${local_path}" "${remote}:${remote_path}"
   fi
@@ -5362,9 +5632,26 @@ fi
 
 #####################################################################################################################VDM
 ######################################## SETUP KEY PATHS
-# the src folder path is where we store the script global env
-VDM_SRC_PATH="/home/${USER}/.config/octojoom"
-# create the folder if not set
+# we set a home path based on OS
+VDM_HOME_PATH=''
+case "$OS_NUMBER" in
+  1) # Linux
+    VDM_HOME_PATH="/home/${USER}"
+    ;;
+  2) # macOS
+    VDM_HOME_PATH="/Users/${USER}"
+    ;;
+  3) # Windows (MSYS/Cygwin)
+    VDM_HOME_PATH="/c/Users/${USER}"
+    ;;
+  *)
+    echo >&2 "ERROR: Unsupported operating system."
+    exit 1
+    ;;
+esac
+# Set the src folder path based on OS
+VDM_SRC_PATH="${VDM_HOME_PATH}/.config/octojoom"
+# Create the folder if not set
 # shellcheck disable=SC2174
 mkdir -p -m '700' "${VDM_SRC_PATH}"
 # first run switch
@@ -5381,7 +5668,7 @@ while [ ${#VDM_REPO_PATH} -le 1 ] || [ ! -d "${VDM_REPO_PATH}" ]; do
   else
     # get the value
     VDM_REPO_PATH=$(getInput "Enter the repository path where we can store the containers' docker-composer.yml deployment files." \
-      "/home/${USER}/Docker" 'Enter Repository Path')
+      "${VDM_HOME_PATH}/Docker" 'Enter Repository Path')
     # keep asking if empty or does exist
     if [ ${#VDM_REPO_PATH} -ge 1 ] && [ ! -d "${VDM_REPO_PATH}" ] && (whiptail --yesno "Can we create the ${VDM_REPO_PATH} repository folder" \
       --title "Create the Path" --backtitle "${BACK_TITLE}" 8 112); then
@@ -5404,7 +5691,7 @@ while [ ${#VDM_PROJECT_PATH} -le 1 ] || [ ! -d "${VDM_PROJECT_PATH}" ]; do
   else
     # get the value
     VDM_PROJECT_PATH=$(getInput "Enter the projects' path where we can store the containers' persistent volumes." \
-      "/home/${USER}/Projects" "Enter Projects' Path")
+      "${VDM_HOME_PATH}/Projects" "Enter Projects' Path")
     # keep asking if empty or does exist
     if [ ${#VDM_PROJECT_PATH} -ge 1 ] && [ ! -d "${VDM_PROJECT_PATH}" ] && (whiptail --yesno "Can we create the ${VDM_PROJECT_PATH} projects folder" \
       --title "Create the Path" --backtitle "${BACK_TITLE}" 8 112); then