Release week 19 (#997)

.wordlist.txt

@@ -37,6 +37,7 @@ autostart
 AutoStart
 backend
 backends
+backlight
 backlights
 backported
 Baïkal
@@ -300,6 +301,7 @@ Kubernetes
 KVM
 LASP
 Laravel
+LBA
 LeMaker
 lcd
 LEDs
@@ -451,6 +453,7 @@ PaperMC
 pasja
 passwd
 passwordless
+PCI
 PCIe
 PCM
 petitboot

docs/hardware.md

@@ -261,6 +261,18 @@ It also features a Gbit LAN for network, with dedicated bus and controller, it w
                    <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/DietPi_ROCKPi4-ARMv8-Bookworm.img.xz">DietPi image</a>
                 </td>
             </tr>
+            <tr>
+                <td><a class="table" href=""><strong>ROCK 4 SE</strong></a></td>
+                <td>
+                   <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/DietPi_ROCK4SE-ARMv8-Bookworm.img.xz">DietPi image</a>
+                </td>
+            </tr>
+            <tr>
+                <td><a class="table" href=""><strong>ROCK 4C Plus</strong></a></td>
+                <td>
+                   <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/DietPi_ROCK4CPlus-ARMv8-Bookworm.img.xz">DietPi image</a>
+                </td>
+            </tr>
             <tr>
                 <td><a class="table" href=""><strong>ROCK Pi S</strong></a></td>
                 <td>
@@ -273,6 +285,12 @@ It also features a Gbit LAN for network, with dedicated bus and controller, it w
                    <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/DietPi_RadxaZero-ARMv8-Bookworm.img.xz">DietPi image</a>
                 </td>
             </tr>
+            <tr>
+                <td><a class="table" href=""><strong>Radxa ZERO 3E / ZERO 3W (testing)</strong></a></td>
+                <td>
+                   <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/testing/DietPi_RadxaZERO3-ARMv8-Bookworm.img.xz">DietPi image</a>
+                </td>
+            </tr>
             <tr>
                 <td><a class="table" href=""><strong>ROCK 3A</strong></a></td>
                 <td>
@@ -291,12 +309,6 @@ It also features a Gbit LAN for network, with dedicated bus and controller, it w
                    <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/DietPi_ROCK5B-ARMv8-Bookworm.img.xz">DietPi image</a>
                 </td>
             </tr>
-            <tr>
-                <td><a class="table" href=""><strong>ROCK 4 SE</strong></a></td>
-                <td>
-                   <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/DietPi_ROCK4SE-ARMv8-Bookworm.img.xz">DietPi image</a>
-                </td>
-            </tr>
         </tbody>
     </table>
 </div>
@@ -569,6 +581,12 @@ For more details visit the [**Orange Pi**](http://www.orangepi.org/index.html) w
                    <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/DietPi_OrangePi5Plus-ARMv8-Bookworm.img.xz">DietPi image</a>
                 </td>
             </tr>
+            <tr>
+                <td><a class="table" href=""><strong>Orange Pi Zero 2W (testing)</strong></a></td>
+                <td>
+                   <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/testing/DietPi_OrangePiZero2W-ARMv8-Bookworm.img.xz">DietPi image</a>
+                </td>
+            </tr>
             <tr>
                 <td><a class="table" href=""><strong>Orange Pi Zero 3</strong></a></td>
                 <td>
@@ -587,6 +605,12 @@ For more details visit the [**Orange Pi**](http://www.orangepi.org/index.html) w
                    <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/DietPi_OrangePi3B-ARMv8-Bookworm.img.xz">DietPi image</a>
                 </td>
             </tr>
+            <tr>
+                <td><a class="table" href=""><strong>Orange Pi 3 LTS (testing)</strong></a></td>
+                <td>
+                   <strong>Download</strong>: <a href="https://dietpi.com/downloads/images/testing/DietPi_OrangePi3LTS-ARMv8-Bookworm.img.xz">DietPi image</a>
+                </td>
+            </tr>
         </tbody>
     </table>
 </div>

docs/releases.md

@@ -5,6 +5,7 @@ description: Overview of DietPi releases with applied new software and features,
 
 # DietPi Releases
 
+- [v9.4 May 2024](releases/v9_4.md)
 - [v9.3 April 2024](releases/v9_3.md)
 - [v9.2 March 2024](releases/v9_2.md)
 - [v9.1 February 2024](releases/v9_1.md)

docs/releases/v9_4.md

@@ -0,0 +1,42 @@
+# Release Notes
+
+## May 2024 (version 9.4)
+
+### Overview
+
+The **May 12th, 2024** release of **DietPi v9.4** comes with a new image for the ROCK 4C Plus.
+
+![Raspberry Pi 5 in grass](../assets/images/dietpi-release-v9_04.jpg){: width="800" height="600" loading="lazy"}
+
+!!! cite "*Photo by `StephanStS`, DietPi*"
+
+### New images
+
+- [**ROCK 4C Plus**](../hardware.md#radxa) :octicons-arrow-right-16: Since our Radxa ROCK 4 image has become incompatible with the ROCK 4C Plus, we provide a new image for this particular variant. Many thanks to @lfiorini and @arpegius5555 for reporting this issue: <https://github.com/MichaIng/DietPi/issues/6593>, <https://github.com/MichaIng/DietPi/issues/6935>
+- [**Orange Pi 3 LTS**](../hardware.md#orange-pi-series) :octicons-arrow-right-16: Added support for this Allwinner H6 based SBC.
+- [**Radxa ZERO 3**](../hardware.md#radxa) :octicons-arrow-right-16: Added support for this Rockchip RK3566 based SBC, the 3E variant with Ethernet as well as the 3W variant with onboard WiFi.
+- [**Orange Pi Zero 2W**](../hardware.md#orange-pi-series) :octicons-arrow-right-16: Support for this small form factor SBC with Allwinner H618 SoC was added.
+
+#### Enhancements
+
+- **General** :octicons-arrow-right-16: Our scripts do now internally enforce the default umask 0022. Many config and install options rely on this, hence it can cause issues when e.g. 0027 (deny read access for "other" users) has been applied on the parent shell. This affects only the (sub)shell of our scripts, while the current and default umask of parent and of shells/consoles remains untouched.
+- [**NanoPi R5C**](../hardware.md#nanopi-series-friendlyelec) :octicons-arrow-right-16: New images, or when flashing the new bootloader binary via `dietpi-config` -> `Advanced Options` -> `Update MMC bootloader`, support M.2 WiFi modules.
+- [**Orange Pi 3B**](../hardware.md#orange-pi-series) :octicons-arrow-right-16: Added an option for updating the SPI bootloader via `dietpi-config` -> `Advanced Options` -> `Update SPI bootloader`.
+- [**Odroid XU4**](../hardware.md#odroid) :octicons-arrow-right-16: The kernel will be upgraded to Linux 6.6.
+- [**DietPi-CloudShell**](../software/system_stats.md#dietpi-cloudshell) enhancements :octicons-arrow-right-16: On Odroid XU4, when using the CloudShell 2 LCD, during configured auto screen off times, the backlight power of the LCD will be disabled as well, to safe energy and avoid still visible black display content. Many thanks to `@smac` for suggesting this enhancement: <https://dietpi.com/forum/t/15331/55>
+- [**DietPi-Config**](../dietpi_tools/system_configuration.md/#dietpi-config) enhancements :octicons-arrow-right-16: Added an option to the LCD display menu to toggle the Odroid XU4 CloudShell 2 LCD.
+- [**DietPi-Software**](../dietpi_tools/software_installation.md#dietpi-software) | [**Snapcast**](../software/media.md#snapcast-server) :octicons-arrow-right-16: 64-bit ARM and Debian Bookworm + Trixie will have the now available packages from Snapcast installed, instead of those from the Debian repository.
+
+#### Bug fixes
+
+- [**NanoPi NEO3**](../hardware.md#nanopi-series-friendlyelec) :octicons-arrow-right-16: Resolved an issue where the Ethernet adapter was not available after reboots. Many thanks to @murraythegoz for reporting this issue: <https://github.com/MichaIng/DietPi/issues/6987>
+- [**Orange Pi Zero 3**](../hardware.md#orange-pi-series) :octicons-arrow-right-16: Resolved an issue on the 1.5 GiB RAM variant, where the Ethernet adapter was not available anymore after soft/warm reboots.
+- [**Orange Pi 5 Plus**](../hardware.md#orange-pi-series) :octicons-arrow-right-16: Resolved an issue where the Ethernet interface names `eth0`/`eth1` could swap on (re)boot. We add a udev rule which assures they are named persistently based on the PCI bus identifier. In case you created own udev rules to mitigate the issue, please check whether they conflict and decide whether to use ours or your solution. The DietPi update will also inform you about this change with a prompt. Many thanks to @dirkhh and many others for reporting this issue: <https://github.com/MichaIng/DietPi/issues/6592>
+- [**DietPi-VPN**](../dietpi_tools/software_installation.md#dietpi-vpn) :octicons-arrow-right-16: Resolved an issue where installing the `IPVanish` config failed, due to a changed URL, and startup failed on Bookworm systems since their configs contain a deprecated option. Many thanks to @DreamPhreak and @Michael-Robson for reporting this issue: <https://github.com/MichaIng/DietPi/issues/7043>
+- **DietPi-Imager** :octicons-arrow-right-16: Resolved an issue where `dietpi-imager` could have failed on GPT partitioned images, if either the source image size did not leave space for the GPT backup partition table, or the first usable LBA/sector was above 34. The GPT backup partition table is now created only at the end of the image generation, not anymore additionally at the start, and the required size it takes is correctly obtained. Many thanks to @SelfhostedPro and @disablewong for reporting this issue: <https://github.com/MichaIng/DietPi/issues/7024>, <https://dietpi.com/forum/t/18035>
+- [**DietPi-Config**](../dietpi_tools/system_configuration.md/#dietpi-config) enhancements :octicons-arrow-right-16: Resolved a visual-only failure message on non-RPi systems, when enabling Bluetooth, and an actual failure doing so on Orange Pi Zero 3, Orange Pi 3B and Orange Pi Zero 2W, since the required kernel module `sprdbt_tty` was not loaded. Many thanks to @b9AcE for reporting this issue: <https://dietpi.com/forum/t/19929/45>
+- [**DietPi-Software**](../dietpi_tools/software_installation.md#dietpi-software) | [**Snapcast**](../software/media.md#snapcast-server) :octicons-arrow-right-16: Resolved an issue where version 0.27.0 was installed, because since version 0.28.0, Snapcast is provided with client and server packages wrapped into one archive, instead having individual downloads for each package.
+- [**DietPi-Software**](../dietpi_tools/software_installation.md#dietpi-software) | [**OctoPrint**](../software/printing.md#octoprint) :octicons-arrow-right-16: Resolved an issue where the installation failed on RISC-V and ARMv6/7 Bullseye systems, due to changed dependencies.
+- [**DietPi-Software**](../dietpi_tools/software_installation.md#dietpi-software) | [**X.Org X Server**](../software/desktop.md#desktop-environments-utilities) :octicons-arrow-right-16: Resolved an issue where an important config file might have been missing on RPi 5 and potentially Amlogic S905 SBCs, if the config directory `/etc/X11/xorg.conf.d` did not exist and was not created as part of the related APT packages. Many thanks to @rmscode for reporting this issue: <https://dietpi.com/forum/t/19963>
+
+As always, many smaller code performance and stability improvements, visual and spelling fixes have been done, too much to list all of them here. Check out all code changes of this release on GitHub: <https://github.com/MichaIng/DietPi/pull/7063>

docs/software/cloud.md

@@ -618,7 +618,7 @@ See also the [**Git**](programming.md#git) client which is available in `dietpi-
     - When you further try to login `maxretry` times, your IP should be banned for `bantime` seconds, so that neither the Gitea web interface, nor SSH or any other network application will respond to requests from your client. When Fail2Ban was installed via `dietpi-software`, by default `route`/`blackhole` blocking is used, so that `ip r` on the server should show a `blackhole` route for your client's IP.
     - See also:
         - [Fail2Ban](system_security.md#fail2ban)
-        - <https://docs.gitea.io/en-us/fail2ban-setup/>
+        - <https://docs.gitea.com/administration/fail2ban-setup>
 
 === "View logs"
 
@@ -640,9 +640,9 @@ See also the [**Git**](programming.md#git) client which is available in `dietpi-
 
 ***
 
-Official website: <https://gitea.io/>  
-Official documentation: <https://docs.gitea.io/>  
-Official forum: <https://discourse.gitea.io/>  
+Official website: <https://about.gitea.com/>  
+Official documentation: <https://docs.gitea.com/>  
+Official forum: <https://forum.gitea.com/>  
 Source code: <https://github.com/go-gitea/gitea>  
 License: [MIT](https://github.com/go-gitea/gitea/blob/main/LICENSE)
 

docs/software/home_automation.md

@@ -37,8 +37,12 @@ Home Assistant is an open-source home automation platform running on Python 3. T
 
 === "Initial install and access"
 
-    !!! info "Long installation duration"
-        The install process on slower SBC models can take a very long time, up to 2 hours, hence take a coffee, find some other activity and check back once in a while. It will show Installing Python-3.x.x... a very long time.  
+    !!! info "Automate install of additional dependencies"
+        Some integrations may require additional APT and/or Python dependencies. The latter are usually installed ondemand by the Home Assistant core, when installing or accessing the integration, but APT packages need to be installed manually.  
+        This can be automated with two `dietpi.txt` settings: `SOFTWARE_HOMEASSISTANT_APT_DEPS` and `SOFTWARE_HOMEASSISTANT_PIP_DEPS`
+
+    !!! warning "Long installation duration"
+        The install process on slower SBC models can take a up to 2 hours, hence take a coffee, find some other activity and check back once in a while. It will show "Installing Python-3.x.x..." a very long time.  
         If you want to see processing details, run `htop` on a dedicated terminal or SSH session to watch Python build process live.
 
     After `dietpi-software` has finished and the service starts the first time, please go through the following steps manually:
@@ -96,15 +100,19 @@ Home Assistant is an open-source home automation platform running on Python 3. T
     /home/homeassistant/homeassistant-update.sh
     ```
 
-    To update as well the whole `pyenv` Python version, reinstall Home Assistant:
+    Home Assistant updates may drop support for old Python versions. The release notes would inform about this: <https://github.com/home-assistant/core/releases>  
+    To update the `pyenv` Python version along with Home Assistant, reinstall it. Since Python dependencies need to be reinstalled, the first service start, and accessing certain integrations for the first time, may again take a while:
 
     ```sh
     dietpi-software reinstall 157
     ```
 
 ***
 
-Official documentation: <https://home-assistant.io/docs>
+Official website: <https://www.home-assistant.io/>  
+Official documentation: <https://home-assistant.io/docs>  
+Source code: <https://github.com/home-assistant/core>  
+License: [Apache-2.0](https://github.com/home-assistant/core/blob/dev/LICENSE.md)
 
 ## Domoticz
 

docs/software/remote_desktop.md

@@ -233,7 +233,7 @@ Examples of TCP ports for Remote.It:
     mawk -F\" '/claim/{print $4}' /etc/remoteit/config.json
     ```
 
-    Then follow these instructions: <https://docs.remote.it/software/device-package/installation#3.-claim-and-register-the-device>
+    Then follow these instructions: <https://docs.remote.it/software/device-package/installation#id-3.-claim-and-register-the-device>
 
 ***
 

docs/software/webserver_stack.md

@@ -99,10 +99,10 @@ DietPi offers an **one-click-installation** of the following web development sta
 === "Which DATABASE to CHOOSE ?"
 
     **[MariaDB](databases.md#mariadb)**  
-    It is an open source RDBMS (relational data base management system). It is application compatible to MySQL, i.e. it can be used as a *drop in* replacement for MySQL. It has more features, fewer bugs, and a better performance compared to MySQL.[^2]
+    It is an open source RDBMS (relational data base management system). It is application compatible to MySQL, i.e. it can be used as a *drop in* replacement for MySQL. It has more features, fewer bugs, and a better performance compared to MySQL.
 
     **[SQLite](databases.md#sqlite)**  
-    It is an RDBMS, also compatible to MySQL. It offers a broader language support (i.e. more bindings to programming languages) compared to [MariaDB](databases.md#mariadb). [SQLite](databases.md#sqlite) has a very small footprint. As drawbacks, it has no multi user capabilities and a couple of SQL features are missing.[^3]
+    It is an RDBMS, also compatible to MySQL. It offers a broader language support (i.e. more bindings to programming languages) compared to [MariaDB](databases.md#mariadb). [SQLite](databases.md#sqlite) has a very small footprint. As drawbacks, it has no memory caching, no multi user capabilities and a couple of SQL features are missing.[^3]
 
 ***
 
@@ -591,7 +591,6 @@ Official documentation: <https://nodejs.org/api/>
 
 <!-- markdownlint-disable MD053 -->
 [^1]: Find out more about the success stories of Nginx on: <https://nginx.org/en/>
-[^2]: ["Dead database walking: MySQL's creator on why the future belongs to MariaDB - MariaDB, open source, mysql, Oracle"](https://www2.computerworld.com.au/article/457551/dead_database_walking_mysql_creator_why_future_belongs_mariadb/). Computerworld. Retrieved 22 November 2020.
 [^3]: [Most Widely Deployed and Used Database Engine](https://www.sqlite.org/mostdeployed.html). Retrieved 12 December 2020
 [^4]: [NGINX vs. Apache: Our View of a Decade-Old Question](https://www.nginx.com/blog/nginx-vs-apache-our-view/). Retrieved 12 December 2020
 [^5]: <https://hostingtribunal.com/blog/node-js-stats/#gref>. Retrieved 29 May 2021

docs/usage.md

@@ -17,6 +17,7 @@ If too much customisation has been done without having it well documented or scr
 ```sh
 dietpi-backup 1
 sed -i 's/stretch/buster/g' /etc/apt/sources.list{,.d/*.list}
+sed -i '/ buster-backports /d' /etc/apt/sources.list
 rm -f /etc/apt/sources.list.d/dietpi-php.list
 rm -f /etc/apt/trusted.gpg.d/dietpi-php.gpg
 rm -f /etc/apt/preferences.d/dietpi-{php,openssl,xrdp}

mkdocs.yml

@@ -141,6 +141,7 @@ nav:
   - Miscellaneous Tools: dietpi_tools/misc_tools.md
 - RELEASES:
   - Overview: releases.md
+  - v9.4 May 2024: releases/v9_4.md
   - v9.3 April 2024: releases/v9_3.md
   - v9.2 March 2024: releases/v9_2.md
   - v9.1 February 2024: releases/v9_1.md