From 5cf453d4fb647f7e023cda8742e869251931e085 Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 11:08:06 +0100
Subject: [PATCH 01/10] Change web files install directory

---
 dockerfiles/start.sh | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dockerfiles/start.sh b/dockerfiles/start.sh
index 01bdd85e..31610056 100755
--- a/dockerfiles/start.sh
+++ b/dockerfiles/start.sh
@@ -37,10 +37,10 @@ fi
 echo "[INSTALL] Setup NGINX"
 
 # Remove /html folder if exists
-sudo rm -R /var/www/html 
+sudo rm -R /var/www/html/pialert 
 
 # create symbolic link to the pialert install directory
-ln -s $INSTALL_DIR/pialert/front /var/www/html 
+ln -s $INSTALL_DIR/pialert/front /var/www/html/pialert 
 # remove dfault NGINX site
 sudo rm /etc/nginx/sites-available/default
 # create symbolic link to NGINX configuaration coming with PiAlert
@@ -77,7 +77,7 @@ fi
 echo "[INSTALL] Fixing file permissions"
 
 
-chmod -R a+rwx /var/www/html
+chmod -R a+rwx /var/www/html/pialert
 chmod -R a+rw $INSTALL_DIR/pialert/front/log
 chmod -R a+rwx $INSTALL_DIR
 

From b9a7516eb819824c4470834552cccc58b469b75d Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 11:44:51 +0100
Subject: [PATCH 02/10] Change NGINX config file name and install directory

---
 dockerfiles/start.sh              | 10 +++++-----
 install/{default => pialert.conf} |  0
 2 files changed, 5 insertions(+), 5 deletions(-)
 rename install/{default => pialert.conf} (100%)

diff --git a/dockerfiles/start.sh b/dockerfiles/start.sh
index 31610056..780ec835 100755
--- a/dockerfiles/start.sh
+++ b/dockerfiles/start.sh
@@ -41,16 +41,16 @@ sudo rm -R /var/www/html/pialert
 
 # create symbolic link to the pialert install directory
 ln -s $INSTALL_DIR/pialert/front /var/www/html/pialert 
-# remove dfault NGINX site
-sudo rm /etc/nginx/sites-available/default
+# remove existing pialert site
+sudo rm /etc/nginx/conf.d/pialert.conf
 # create symbolic link to NGINX configuaration coming with PiAlert
-sudo ln -s "$INSTALL_DIR/pialert/install/default" /etc/nginx/sites-available/default
+sudo ln -s "$INSTALL_DIR/pialert/install/pialert.conf" /etc/nginx/conf.d/pialert.conf
 # use user-supplied port
-sudo sed -i 's/listen 80/listen '"$PORT"'/g' /etc/nginx/sites-available/default
+sudo sed -i 's/listen 80/listen '"$PORT"'/g' /etc/nginx/conf.d/pialert.conf
 
 # Change web interface address if set
 if [ -n "${LISTEN_ADDR}" ]; then  
-  sed -ie 's/listen /listen '${LISTEN_ADDR}:'/g' /etc/nginx/sites-available/default
+  sed -ie 's/listen /listen '${LISTEN_ADDR}:'/g' /etc/nginx/conf.d/pialert.conf
 fi
 
 # Run the hardware vendors update at least once
diff --git a/install/default b/install/pialert.conf
similarity index 100%
rename from install/default
rename to install/pialert.conf

From aab910f68abda85f670bf8ca36f71299c0a7479e Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 11:56:57 +0100
Subject: [PATCH 03/10] Change default port to 20211 as in docker container

---
 dockerfiles/start.sh | 7 +++++--
 install/pialert.conf | 4 ++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/dockerfiles/start.sh b/dockerfiles/start.sh
index 780ec835..1082919c 100755
--- a/dockerfiles/start.sh
+++ b/dockerfiles/start.sh
@@ -45,8 +45,11 @@ ln -s $INSTALL_DIR/pialert/front /var/www/html/pialert
 sudo rm /etc/nginx/conf.d/pialert.conf
 # create symbolic link to NGINX configuaration coming with PiAlert
 sudo ln -s "$INSTALL_DIR/pialert/install/pialert.conf" /etc/nginx/conf.d/pialert.conf
-# use user-supplied port
-sudo sed -i 's/listen 80/listen '"$PORT"'/g' /etc/nginx/conf.d/pialert.conf
+
+# Use user-supplied port if set
+if [ -n "${PORT}" ]; then  
+  sudo sed -i 's/listen 20211/listen '"$PORT"'/g' /etc/nginx/conf.d/pialert.conf
+fi
 
 # Change web interface address if set
 if [ -n "${LISTEN_ADDR}" ]; then  
diff --git a/install/pialert.conf b/install/pialert.conf
index 387791c2..8821dee3 100755
--- a/install/pialert.conf
+++ b/install/pialert.conf
@@ -1,5 +1,5 @@
 server {
-    listen 80 default_server;
+    listen 20211 default_server;
     root /var/www/html;
     index index.php;
     #rewrite /pialert/(.*) / permanent;
@@ -15,4 +15,4 @@ server {
           fastcgi_send_timeout 600;
           fastcgi_read_timeout 600;
   }
-}
\ No newline at end of file
+}

From c14fa5606db839ec538b60d30b12cf091dbd43e2 Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 12:25:17 +0100
Subject: [PATCH 04/10] Disable default NGINX site

---
 dockerfiles/start.sh | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/dockerfiles/start.sh b/dockerfiles/start.sh
index 1082919c..252e6ff5 100755
--- a/dockerfiles/start.sh
+++ b/dockerfiles/start.sh
@@ -46,6 +46,13 @@ sudo rm /etc/nginx/conf.d/pialert.conf
 # create symbolic link to NGINX configuaration coming with PiAlert
 sudo ln -s "$INSTALL_DIR/pialert/install/pialert.conf" /etc/nginx/conf.d/pialert.conf
 
+# remove default NGINX site if it is symlinked, or backup it otherwise
+if [ -L /etc/nginx/sites-enabled/default ] ; then
+  sudo rm /etc/nginx/sites-enabled/default
+else
+  sudo mv /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.bkp_pialert
+fi
+
 # Use user-supplied port if set
 if [ -n "${PORT}" ]; then  
   sudo sed -i 's/listen 20211/listen '"$PORT"'/g' /etc/nginx/conf.d/pialert.conf

From a0d34876cced81a21f22ccbf908a76671ef8d22e Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 12:38:07 +0100
Subject: [PATCH 05/10] Fix web root

---
 install/pialert.conf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/install/pialert.conf b/install/pialert.conf
index 8821dee3..88db31dc 100755
--- a/install/pialert.conf
+++ b/install/pialert.conf
@@ -1,6 +1,6 @@
 server {
     listen 20211 default_server;
-    root /var/www/html;
+    root /var/www/html/pialert;
     index index.php;
     #rewrite /pialert/(.*) / permanent;
     add_header X-Forwarded-Prefix "/pialert" always;

From 1e75eeab4c172615734f192f5fda26dc51ddc9fc Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 14:09:52 +0100
Subject: [PATCH 06/10] Create buildtimestamp.txt if not exists, fix shellcheck
 warnings

---
 back/update_vendors.sh      | 12 ++++++------
 dockerfiles/start.sh        |  4 ++--
 dockerfiles/user-mapping.sh | 16 ++++++++--------
 install/install.sh          |  4 ++++
 4 files changed, 20 insertions(+), 16 deletions(-)

diff --git a/back/update_vendors.sh b/back/update_vendors.sh
index ec6aa5c5..7ce6c4f1 100755
--- a/back/update_vendors.sh
+++ b/back/update_vendors.sh
@@ -20,15 +20,15 @@ echo "---------------------------------------------------------"
 
 # ----------------------------------------------------------------------
 echo Updating... /usr/share/ieee-data/
-cd /usr/share/ieee-data/
+cd /usr/share/ieee-data/ || { echo "could not enter /usr/share/ieee-data directory"; exit 1; }
 
 sudo mkdir -p 2_backup
-sudo cp *.txt 2_backup
-sudo cp *.csv 2_backup
+sudo cp -- *.txt 2_backup
+sudo cp -- *.csv 2_backup
 echo ""
 echo Download Start
 echo ""
-sudo curl $1  -LO https://standards-oui.ieee.org/iab/iab.csv \
+sudo curl "$1"  -LO https://standards-oui.ieee.org/iab/iab.csv \
               -LO https://standards-oui.ieee.org/iab/iab.txt \
               -LO https://standards-oui.ieee.org/oui28/mam.csv \
               -LO https://standards-oui.ieee.org/iab/iab.txt \
@@ -44,10 +44,10 @@ echo Download Finished
 # ----------------------------------------------------------------------
 echo ""
 echo Updating... /usr/share/arp-scan/
-cd /usr/share/arp-scan
+cd /usr/share/arp-scan || { echo "could not enter /usr/share/arp-scan directory"; exit 1; }
 
 sudo mkdir -p 2_backup
-sudo cp *.txt 2_backup
+sudo cp -- *.txt 2_backup
 
 # Update from /usb/lib/ieee-data
 sudo get-iab -v
diff --git a/dockerfiles/start.sh b/dockerfiles/start.sh
index 252e6ff5..1c5bc001 100755
--- a/dockerfiles/start.sh
+++ b/dockerfiles/start.sh
@@ -31,7 +31,7 @@ echo "[INSTALL] Run setup scripts"
 
 # Change port number if set
 if [ -n "${PORT}" ]; then  
-  sed -ie 's/listen 20211/listen '${PORT}'/g' /etc/nginx/sites-available/default
+  sed -ie 's/listen 20211/listen '"${PORT}"'/g' /etc/nginx/sites-available/default
 fi 
 
 echo "[INSTALL] Setup NGINX"
@@ -60,7 +60,7 @@ fi
 
 # Change web interface address if set
 if [ -n "${LISTEN_ADDR}" ]; then  
-  sed -ie 's/listen /listen '${LISTEN_ADDR}:'/g' /etc/nginx/conf.d/pialert.conf
+  sed -ie 's/listen /listen '"${LISTEN_ADDR}":'/g' /etc/nginx/conf.d/pialert.conf
 fi
 
 # Run the hardware vendors update at least once
diff --git a/dockerfiles/user-mapping.sh b/dockerfiles/user-mapping.sh
index 40dd4ec2..eeff48bd 100755
--- a/dockerfiles/user-mapping.sh
+++ b/dockerfiles/user-mapping.sh
@@ -9,7 +9,7 @@ if [ -z "${USER}" ]; then
 fi
 
 # if both not set we do not need to do anything
-if [ -z "${HOST_USER_ID}" -a -z "${HOST_USER_GID}" ]; then
+if [ -z "${HOST_USER_ID}" ] && [ -z "${HOST_USER_GID}" ]; then
     echo "Nothing to do here." ; exit 0
 fi
 
@@ -20,20 +20,20 @@ USER_GID=${HOST_USER_GID:=$USER_GID}
 
 LINE=$(grep -F "${USER}" /etc/passwd)
 # replace all ':' with a space and create array
-array=( ${LINE//:/ } )
+array=( "${LINE//:/ }" )
 
 # home is 5th element
 USER_HOME=${array[4]}
 
 # print debug output
-echo  USER_ID  : ${USER_ID};
-echo  USER_GID : ${USER_GID};
-echo  USER_HOME: ${USER_HOME};
-echo  TZ       : ${TZ};
+echo  USER_ID"  ": "${USER_ID}";
+echo  USER_GID : "${USER_GID}";
+echo  USER_HOME: "${USER_HOME}";
+echo  TZ"       ": "${TZ}";
 
 sed -i -e "s/^${USER}:\([^:]*\):[0-9]*:[0-9]*/${USER}:\1:${USER_ID}:${USER_GID}/"  /etc/passwd
 sed -i -e "s/^${USER}:\([^:]*\):[0-9]*/${USER}:\1:${USER_GID}/"  /etc/group
 
-chown -R ${USER_ID}:${USER_GID} ${USER_HOME}
+chown -R "${USER_ID}:${USER_GID} ${USER_HOME}"
 
-exec su - "${USER}"
\ No newline at end of file
+exec su - "${USER}"
diff --git a/install/install.sh b/install/install.sh
index 1e9ccca6..05900535 100755
--- a/install/install.sh
+++ b/install/install.sh
@@ -26,6 +26,10 @@ rm -R $INSTALL_DIR/pialert
 # Clone the application repository
 git clone https://github.com/jokob-sk/Pi.Alert "$INSTALL_DIR/pialert"
 
+# Check for buildtimestamp.txt existence, otherwise create it
+if [ ! -f /home/pi/pialert/front/buildtimestamp.txt ]; then
+  date +%s > /home/pi/pialert/front/buildtimestamp.txt
+fi
 
 # Start PiAlert
 "$INSTALL_DIR/pialert/dockerfiles/start.sh"

From 0bd985282f4f84596f228ee486d2071a070bb31b Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 14:35:34 +0100
Subject: [PATCH 07/10] Refactor shell scripts

---
 dockerfiles/start.sh | 50 ++++++++++++++++++++++++++------------------
 install/install.sh   |  4 ++--
 2 files changed, 32 insertions(+), 22 deletions(-)

diff --git a/dockerfiles/start.sh b/dockerfiles/start.sh
index 1c5bc001..dbf837f2 100755
--- a/dockerfiles/start.sh
+++ b/dockerfiles/start.sh
@@ -7,6 +7,11 @@ echo "---------------------------------------------------------"
 
 INSTALL_DIR=/home/pi  # Specify the installation directory here
 
+# DO NOT CHANGE ANYTHING BELOW THIS LINE!
+WEB_UI_DIR=/var/www/html/pialert
+NGINX_CONFIG_FILE=/etc/nginx/conf.d/pialert.conf
+# DO NOT CHANGE ANYTHING ABOVE THIS LINE!
+
 # if custom variables not set we do not need to do anything
 if [ -n "${TZ}" ]; then    
   FILECONF=$INSTALL_DIR/pialert/config/pialert.conf 
@@ -29,37 +34,42 @@ echo "[INSTALL] Run setup scripts"
 "$INSTALL_DIR/pialert/dockerfiles/user-mapping.sh"
 "$INSTALL_DIR/pialert/install/install_dependencies.sh" # if modifying this file transfer the chanegs into the root Dockerfile as well!
 
-# Change port number if set
-if [ -n "${PORT}" ]; then  
-  sed -ie 's/listen 20211/listen '"${PORT}"'/g' /etc/nginx/sites-available/default
-fi 
-
 echo "[INSTALL] Setup NGINX"
 
-# Remove /html folder if exists
-sudo rm -R /var/www/html/pialert 
-
-# create symbolic link to the pialert install directory
-ln -s $INSTALL_DIR/pialert/front /var/www/html/pialert 
-# remove existing pialert site
-sudo rm /etc/nginx/conf.d/pialert.conf
-# create symbolic link to NGINX configuaration coming with PiAlert
-sudo ln -s "$INSTALL_DIR/pialert/install/pialert.conf" /etc/nginx/conf.d/pialert.conf
-
-# remove default NGINX site if it is symlinked, or backup it otherwise
+# Remove default NGINX site if it is symlinked, or backup it otherwise
 if [ -L /etc/nginx/sites-enabled/default ] ; then
+  echo "Disabling default NGINX site, removing sym-link in /etc/nginx/sites-enabled"
   sudo rm /etc/nginx/sites-enabled/default
-else
+elif [ -f /etc/nginx/sites-enabled/default ]; then
+  echo "Disabling default NGINX site, moving config to /etc/nginx/sites-available"
   sudo mv /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.bkp_pialert
 fi
 
+# Clear existing directories and files
+if [ -d $WEB_UI_DIR ]; then
+  echo "Removing existing PiAlert web-UI"
+  sudo rm -R $WEB_UI_DIR
+fi
+
+if [ -f $NGINX_CONFIG_FILE ]; then
+  echo "Removing existing PiAlert NGINX config"
+  sudo rm $NGINX_CONFIG_FILE
+fi
+
+# create symbolic link to the pialert install directory
+ln -s $INSTALL_DIR/pialert/front $WEB_UI_DIR
+# create symbolic link to NGINX configuaration coming with PiAlert
+sudo ln -s "$INSTALL_DIR/pialert/install/pialert.conf" /etc/nginx/conf.d/pialert.conf
+
 # Use user-supplied port if set
-if [ -n "${PORT}" ]; then  
+if [ -n "${PORT}" ]; then
+  echo "Setting webserver to user-supplied port ($PORT)"
   sudo sed -i 's/listen 20211/listen '"$PORT"'/g' /etc/nginx/conf.d/pialert.conf
 fi
 
 # Change web interface address if set
-if [ -n "${LISTEN_ADDR}" ]; then  
+if [ -n "${LISTEN_ADDR}" ]; then
+  echo "Setting webserver to user-supplied address ($LISTEN_ADDR)"
   sed -ie 's/listen /listen '"${LISTEN_ADDR}":'/g' /etc/nginx/conf.d/pialert.conf
 fi
 
@@ -87,7 +97,7 @@ fi
 echo "[INSTALL] Fixing file permissions"
 
 
-chmod -R a+rwx /var/www/html/pialert
+chmod -R a+rwx $WEB_UI_DIR
 chmod -R a+rw $INSTALL_DIR/pialert/front/log
 chmod -R a+rwx $INSTALL_DIR
 
diff --git a/install/install.sh b/install/install.sh
index 05900535..832488fc 100755
--- a/install/install.sh
+++ b/install/install.sh
@@ -27,8 +27,8 @@ rm -R $INSTALL_DIR/pialert
 git clone https://github.com/jokob-sk/Pi.Alert "$INSTALL_DIR/pialert"
 
 # Check for buildtimestamp.txt existence, otherwise create it
-if [ ! -f /home/pi/pialert/front/buildtimestamp.txt ]; then
-  date +%s > /home/pi/pialert/front/buildtimestamp.txt
+if [ ! -f $INSTALL_DIR/pialert/front/buildtimestamp.txt ]; then
+  date +%s > $INSTALL_DIR/pialert/front/buildtimestamp.txt
 fi
 
 # Start PiAlert

From 790e98d8a7449bf201958ca98231eb9ea838b7fc Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 14:40:26 +0100
Subject: [PATCH 08/10] Remove empty buildtimestamp.txt

---
 front/buildtimestamp.txt | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100755 front/buildtimestamp.txt

diff --git a/front/buildtimestamp.txt b/front/buildtimestamp.txt
deleted file mode 100755
index e69de29b..00000000

From 692cf9305d758f013b73f8ae23f7bd8c0210f151 Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Wed, 15 Nov 2023 15:18:48 +0100
Subject: [PATCH 09/10] More refactoring

---
 back/update_vendors.sh          | 3 ++-
 dockerfiles/start.sh            | 8 +++-----
 dockerfiles/user-mapping.sh     | 2 +-
 install/install.sh              | 2 +-
 install/install_dependencies.sh | 2 +-
 5 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/back/update_vendors.sh b/back/update_vendors.sh
index 7ce6c4f1..a1881dc4 100755
--- a/back/update_vendors.sh
+++ b/back/update_vendors.sh
@@ -1,4 +1,5 @@
-#!/bin/sh
+#!/usr/bin/env bash
+
 # ------------------------------------------------------------------------------
 #  Pi.Alert
 #  Open Source Network Guard / WIFI & LAN intrusion detector 
diff --git a/dockerfiles/start.sh b/dockerfiles/start.sh
index dbf837f2..96a23a03 100755
--- a/dockerfiles/start.sh
+++ b/dockerfiles/start.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 echo "---------------------------------------------------------"
 echo "[INSTALL]                                    Run start.sh"
@@ -10,6 +10,7 @@ INSTALL_DIR=/home/pi  # Specify the installation directory here
 # DO NOT CHANGE ANYTHING BELOW THIS LINE!
 WEB_UI_DIR=/var/www/html/pialert
 NGINX_CONFIG_FILE=/etc/nginx/conf.d/pialert.conf
+OUI_FILE="/usr/share/arp-scan/ieee-oui.txt" # Define the path to ieee-oui.txt and ieee-iab.txt
 # DO NOT CHANGE ANYTHING ABOVE THIS LINE!
 
 # if custom variables not set we do not need to do anything
@@ -76,11 +77,8 @@ fi
 # Run the hardware vendors update at least once
 echo "[INSTALL] Run the hardware vendors update"
 
-# Define the path to ieee-oui.txt and ieee-iab.txt
-oui_file="/usr/share/arp-scan/ieee-oui.txt"
-
 # Check if ieee-oui.txt or ieee-iab.txt exist
-if [ -f "$oui_file" ]; then
+if [ -f "$OUI_FILE" ]; then
   echo "The file ieee-oui.txt exists. Skipping update_vendors.sh..."
 else
   echo "The file ieee-oui.txt does not exist. Running update_vendors..."
diff --git a/dockerfiles/user-mapping.sh b/dockerfiles/user-mapping.sh
index eeff48bd..a80ec0b4 100755
--- a/dockerfiles/user-mapping.sh
+++ b/dockerfiles/user-mapping.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 echo "---------------------------------------------------------"
 echo "[INSTALL]                             Run user-mapping.sh"
diff --git a/install/install.sh b/install/install.sh
index 832488fc..ea08e9f3 100755
--- a/install/install.sh
+++ b/install/install.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 echo "---------------------------------------------------------"
 echo "[INSTALL]                                  Run install.sh"
diff --git a/install/install_dependencies.sh b/install/install_dependencies.sh
index 4e54dea5..ea6a6a96 100755
--- a/install/install_dependencies.sh
+++ b/install/install_dependencies.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 echo "---------------------------------------------------------"
 echo "[INSTALL]                     Run install_dependencies.sh"

From c7913c389f09d5681ba5e18f35fa3fe8ab543c82 Mon Sep 17 00:00:00 2001
From: Markus Lorenz <lorenz.markus1997@gmail.com>
Date: Thu, 16 Nov 2023 10:14:18 +0100
Subject: [PATCH 10/10] Extend HW install docs

---
 docs/HW_INSTALL.md | 34 +++++++++++++++++++++++++++++-----
 1 file changed, 29 insertions(+), 5 deletions(-)

diff --git a/docs/HW_INSTALL.md b/docs/HW_INSTALL.md
index d093ba49..768aa86b 100755
--- a/docs/HW_INSTALL.md
+++ b/docs/HW_INSTALL.md
@@ -1,12 +1,37 @@
 # How to install PiAlert on the server hardware
 
-To download and install PiAlert on the hardware/server directly use `curl` or `wget` commands. 
+To download and install PiAlert on the hardware/server directly use `curl` or `wget` commands.
 
-> [!NOTE] 
-> This is an Experimental feature 🧪 and it relies on community support. 
+> [!NOTE]
+> This is an Experimental feature 🧪 and it relies on community support.
+>
+> There is no guarantee that the install script or any other script will gracefully handle other installed software.
+> Data loss is a possibility, **it is recommended to install PiAlert using the supplied Docker image**.
+
+A warning to the installation method below: Piping to bash is [controversial](https://pi-hole.net/2016/07/25/curling-and-piping-to-bash) and may
+be dangerous, as you cannot see the code that's about to be executed on your system.
+
+Alternatively you can download the installation script `install/install.sh` from the repository and check the code yourself (beware other scripts are
+downloaded too - only from this repo).
 
 PiAlert will be installed in `home/pi/pialert/` and run on port number `20211`.
 
+Some facts about what and where something will be changed/installed by the HW install setup (may not contain everything!):
+
+- `/home/pi/pialert` directory will be deleted and newly created
+- `/home/pi/pialert` will contain the whole repository (downloaded by `install/install.sh`)
+- The default NGINX site `/etc/nginx/sites-enabled/default` will be disabled (sym-link deleted or backed up to `sites-available`)
+- `/var/www/html/pialert` directory will be deleted and newly created
+- `/etc/nginx/conf.d/pialert.conf` will be sym-linked to `/home/pi/pialert/install/pialert.conf`
+- Some files (IEEE device vendors info, ...) will be created in the directory where the installation script is executed
+
+## Limitations
+
+- No system service is provided. PiAlert must be started using `/home/pi/pialert/dockerfiles/start.sh`.
+- No checks for other running software is done.
+- Only tested to work on Debian Bookworm (Debian 12).
+- **EXPERIMENTAL** and not recommended way to install PiAlert.
+
 ## CURL
 
 ```bash
@@ -15,11 +40,10 @@ curl -o install.sh https://raw.githubusercontent.com/jokob-sk/Pi.Alert/main/inst
 
 ## WGET
 
-
 ```bash
 wget https://raw.githubusercontent.com/jokob-sk/Pi.Alert/main/install/install.sh -O install.sh && sudo chmod +x install.sh && sudo ./install.sh
 ```
 
 These commands will download the `install.sh` script from the GitHub repository, make it executable with `chmod`, and then run it using `./install.sh`.
 
-Make sure you have the necessary permissions to execute the script.
\ No newline at end of file
+Make sure you have the necessary permissions to execute the script.