From 2fb0e8157da48942d333bd6e2564de57214565f9 Mon Sep 17 00:00:00 2001
From: billz <billzimmerman@gmail.com>
Date: Fri, 3 Nov 2023 13:13:19 +0100
Subject: [PATCH] Update for latest distros, php version + debug log

---
 docs/manual.md | 42 ++++++++++++++++++++++++------------------
 1 file changed, 24 insertions(+), 18 deletions(-)

diff --git a/docs/manual.md b/docs/manual.md
index 1bc011e7..3116621a 100644
--- a/docs/manual.md
+++ b/docs/manual.md
@@ -46,6 +46,12 @@ On Debian, Armbian and Ubuntu, install `dhcpcd5` with the following:
 sudo apt-get install dhcpcd5
 ```
 
+On Raspberry Pi OS Lite 32-bit (bookworm), install `dhcpcd5` with a dependency:
+
+```
+sudo apt-get install dhcpcd dhcpcd-base
+```
+
 ## Ubuntu-specific steps
 !!! note "Note"
     This section concerns manual pre- and post-install steps required for the latest Ubuntu 23.04 (Lunar Lobster) release. They are not necessary with other distributions.
@@ -65,13 +71,13 @@ RaspAP's installer will prompt you to stop and disable the `systemd-resolved` se
 Your RaspAP install on Ubuntu should now function as expected.
 
 ## Install packages
-Install git, lighttpd, php7, hostapd, dnsmasq and some extra packages with the following:
+Install git, lighttpd, php8, hostapd, dnsmasq and some extra packages with the following:
 
 ```
-sudo apt-get install lighttpd git hostapd dnsmasq iptables-persistent vnstat qrencode php7.3-cgi
+sudo apt-get install lighttpd git hostapd dnsmasq iptables-persistent vnstat qrencode php8.2-cgi
 ```
 !!! note "Note"
-    For Debian 12 and Armbian 23.05, replace `php7.3-cgi` with `php8.2-cgi`. For Ubuntu Server 23.04, you may use `php8.1-cgi`.
+    For Raspberry Pi OS Lite (bullseye), Debian 11 and Ubuntu Server 22.04, replace `php8.2-cgi` with `php7.4-cgi`. For Ubuntu Server 23.04, you may use `php8.1-cgi`.
 
 ## Enable PHP
 Next, enable PHP for `lighttpd` and restart the service for the settings to take effect:
@@ -129,12 +135,7 @@ sudo mkdir /etc/raspap/backups
 sudo mkdir /etc/raspap/networking
 sudo mkdir /etc/raspap/hostapd
 sudo mkdir /etc/raspap/lighttpd
-```
-
-Move RaspAP's auth control file to the configuration directory you created above:
-
-```
-sudo cp raspap.php /etc/raspap 
+sudo mkdir /etc/raspap/system
 ```
 
 ## Set permissions
@@ -149,21 +150,26 @@ sudo chown -R www-data:www-data /etc/raspap
 RaspAP uses several shell scripts to manage various aspects of the application, including `hostapd` logging and `raspapd`, the RaspAP control service. Move these scripts to their destinations with the following:
 
 ```
-sudo mv installers/*log.sh /etc/raspap/hostapd 
-sudo mv installers/service*.sh /etc/raspap/hostapd
+sudo mv installers/enablelog.sh /etc/raspap/hostapd
+sudo mv installers/disablelog.sh /etc/raspap/hostapd
+sudo mv installers/servicestart.sh /etc/raspap/hostapd
+sudo mv installers/debuglog.sh /etc/raspap/system
 ```
 
 Set ownership and permissions for the logging and service control scripts:
 
 ```
-sudo chown -c root:www-data /etc/raspap/hostapd/*.sh 
-sudo chmod 750 /etc/raspap/hostapd/*.sh 
+sudo chown -c root:root /etc/raspap/hostapd/*.sh
+sudo chmod 750 /etc/raspap/hostapd/*.sh
+
+sudo chown -c root:root /etc/raspap/system/*.sh
+sudo chmod 750 /etc/raspap/system/*.sh
 ```
 
 Copy and set ownership of the `lighttpd` control scripts:
 ```
 sudo cp installers/configport.sh /etc/raspap/lighttpd
-sudo chown -c root:www-data /etc/raspap/lighttpd/*.sh
+sudo chown -c root:root /etc/raspap/lighttpd/*.sh
 ```
 
 Next, move the `raspapd` service file to the correct location and enable it:
@@ -203,11 +209,11 @@ sudo cp config/raspap-br0-member-eth0.network /etc/systemd/network/raspap-br0-me
 ```
 
 ## Optimize PHP
-Optionally, you may optimize PHP with the following, replacing `php7.3-cgi` with your installed version:
+Optionally, you may optimize PHP with the following, replacing `php8.2-cgi` with your installed version:
 
 ```
-sudo sed -i -E 's/^session\.cookie_httponly\s*=\s*(0|([O|o]ff)|([F|f]alse)|([N|n]o))\s*$/session.cookie_httponly = 1/' /etc/php/7.3/cgi/php.ini
-sudo sed -i -E 's/^;?opcache\.enable\s*=\s*(0|([O|o]ff)|([F|f]alse)|([N|n]o))\s*$/opcache.enable = 1/' /etc/php/7.3/cgi/php.ini
+sudo sed -i -E 's/^session\.cookie_httponly\s*=\s*(0|([O|o]ff)|([F|f]alse)|([N|n]o))\s*$/session.cookie_httponly = 1/' /etc/php/8.2/cgi/php.ini
+sudo sed -i -E 's/^;?opcache\.enable\s*=\s*(0|([O|o]ff)|([F|f]alse)|([N|n]o))\s*$/opcache.enable = 1/' /etc/php/8.2/cgi/php.ini
 sudo phpenmod opcache
 ```
 
@@ -255,7 +261,7 @@ Copy the OpenVPN auth control script to its destination, setting ownership and p
 ```
 sudo mkdir /etc/raspap/openvpn/
 sudo cp installers/configauth.sh /etc/raspap/openvpn/
-sudo chown -c root:www-data /etc/raspap/openvpn/*.sh 
+sudo chown -c root:root /etc/raspap/openvpn/*.sh
 sudo chmod 750 /etc/raspap/openvpn/*.sh
 ```