Release week 38

.wordlist.txt

@@ -93,6 +93,7 @@ CORS
 Coturn
 CouchPotato
 COVID
+CRC
 CRDA
 cron
 CSI
@@ -166,6 +167,7 @@ filesystem
 filesystems
 FirstBoot
 fka
+FlightAware
 ForkedDaapd
 FOSS
 foto
@@ -199,6 +201,7 @@ Gogs
 Golang
 GOMODCACHE
 GOPATH
+GPG
 GPIO
 GPIOs
 GPL
@@ -273,8 +276,10 @@ JSON
 JunoBloom
 JustBoom
 JVM
+Kavita
 Kbit
 Keychain
+keyring
 KiB
 kickstart
 Kickstarter
@@ -459,6 +464,7 @@ Plex
 Portainer
 POSIX
 PostBoot
+poweroff
 pre
 preboot
 preconfigured
@@ -548,7 +554,9 @@ scrollback
 SDK
 SDL
 SDN
+SDR
 SDRAM
+SDRs
 selectable
 Servarr
 serverless
@@ -650,6 +658,7 @@ Tumblr
 Tyrian
 uae
 UART
+UAT
 Uber
 Ubooquity
 udev

docs/releases.md

@@ -5,6 +5,7 @@ description: Overview of DietPi releases with applied new software and features,
 
 # DietPi Releases
 
+- [v8.22 September 2023](v8_22/)
 - [v8.21 August 2023](v8_21/)
 - [v8.20 July 2023, vol 2](v8_20/)
 - [v8.19 July 2023](v8_19/)

docs/releases/v6_30.md

@@ -24,4 +24,4 @@ Last but certainly not least, a big **Thank You** to the following people who co
 - @dasrocky: Many thanks for reporting this issue: <https://github.com/MichaIng/DietPi/issues/3510>
 - @Adsouza98: Many thanks for reporting this issue: <https://github.com/MichaIng/DietPi/issues/3511>
 - @PeterLacknase and @fnsnyc: Many thanks for reporting these issues: <https://github.com/MichaIng/DietPi/issues/3505>, <https://github.com/MichaIng/DietPi/issues/3520>
-- @Vec7or and @littis: Many thanks for reporting these issues: <https://github.com/MichaIng/DietPi/issues/3509>, <https://github.com/MichaIng/DietPi/issues/3513>
+- @Vec7or and @steeletech77: Many thanks for reporting these issues: <https://github.com/MichaIng/DietPi/issues/3509>, <https://github.com/MichaIng/DietPi/issues/3513>

docs/releases/v8_22.md

@@ -0,0 +1,42 @@
+# Release Notes
+
+## September 2023 (version 8.22)
+
+### Overview
+
+The **September 23th, 2023** release of **DietPi v8.22** comes with complete new images in the `.xz` format and with an editable `dietpi.txt` now for all images and a couple of improvements and bug fixes.
+
+![Chair and leaves](../assets/images/dietpi-release-v8_22.jpg){: width="480" height="320" loading="lazy"}
+
+!!! cite "*Photo by `qimono`, Pixabay*"
+
+### New images
+
+- [**All images**](../../hardware/) :octicons-arrow-right-16: DietPi images are now shipped with a trailing FAT partition which contains `dietpi.txt` and other config files for easier pre-configuration and automation from Windows and macOS hosts. The partition is removed automatically on first boot, after copying all supported config files/scripts. Related CLI flags have been added to our build scripts: `--add-fat-part` for `dietpi-imager` and `--no-fat-part` for `dietpi-build`. Many thanks to @dirkhh for implementing this feature: <https://github.com/MichaIng/DietPi/pull/6602>
+- [**All images**](../../hardware/) :octicons-arrow-right-16: All our images are now compressed via `xz` instead of `7z`. These are a little easier to handle, especially on Linux hosts, and many flashing utilities allow to flash xz-compressed images directly to disk, without the need to manually decompress them first. As `xz` compresses files and no directories, the dedicated `README.md` and hash text files are not included anymore. The hashes for integrity checks within an archive have no real purpose, as the compression algorithms imply hashes internally (CRC64 in case of `xz`), which are checked and integrity of the content checked as part of the decompression.
+- [**All images**](../../hardware/) :octicons-arrow-right-16: SHA256 hashes and GPG signatures are now provided for all our images, linked from our download page or found here: <https://dietpi.com/downloads/images/>. Our public GPG keyring can be found at <https://github.com/MichaIng.gpg>.
+- [**All images**](../../hardware/) :octicons-arrow-right-16: Most of our images, those with do not ship with a very old Linux version, have no entropy daemon pre-installed anymore. Either `rngd` or `haveged` were required previously to assure that the system entropy pool remained sufficiently filled, otherwise boot, service starts, cryptography tasks or anything using random character from `/dev/random` could have hung. Recent Linux versions however fill the entropy pool from hardware random generators sufficiently by themselves, and have a `HAVEGE`-like fallback as well if no hardware random generator is available.
+
+### New software
+
+- [**DietPi-Software**](../../dietpi_tools/software_installation/#dietpi-software) | [**ADS-B Feeder**](../../software/distributed_projects/#ads-b-feeder) :octicons-arrow-right-16: Track airplanes using SDRs and feed the data to ADS-B aggregators. Many thanks to @dirkhh for maintaining and implementing this software option: <https://github.com/MichaIng/DietPi/pull/6587>
+- [**DietPi-Software**](../../dietpi_tools/software_installation/#dietpi-software) | [**Kavita**](../../software/media/#kavita) :octicons-arrow-right-16: This open source comics/mangas/ebooks media server with a built-in web reader has been added to our software catalogue. Many thanks to @drahen for implementing this software option: <https://github.com/MichaIng/DietPi/pull/6610>
+
+### Enhancements
+
+- [**DietPi-Software**](../../dietpi_tools/software_installation/#dietpi-software) | [**DietPi-CloudShell**](../../software/system_stats/#dietpi-cloudshell) :octicons-arrow-right-16: The date/time output format at the top of every 3rd scene is now localised.
+- [**DietPi-Software**](../../dietpi_tools/software_installation/#dietpi-software) | [**Docker**](../../software/programming/#docker) :octicons-arrow-right-16: Enabled for Trixie and RISC-V via `docker.io` package from Debian repository.
+- [**DietPi-Software**](../../dietpi_tools/software_installation/#dietpi-software) | [**Portainer**](../../software/programming/#portainer) :octicons-arrow-right-16: Enabled for RISC-V as Docker is now supported on RISC-V as well.
+
+### Bug fixes
+
+- [**NanoPi R4S**](../../hardware/#nanopi-series-friendlyelec) :octicons-arrow-right-16: Resolved a v8.20 regression where the Ethernet LEDs did not react correctly after the kernel upgrade. Many thanks to @idaanx for reporting this issue: <https://github.com/MichaIng/DietPi/issues/6342#issuecomment-1697669420>
+- [**Orange Pi 5**](../../hardware/#orange-pi-series) :octicons-arrow-right-16: Resolved a v8.21 regression where the update may have lead to an unbootable system or caused other issues like missing HDMI output, because of a falsely set device tree file name.
+- [**Odroid C1**](../../hardware/#odroid) :octicons-arrow-right-16: Resolved an issue where the latest kernel upgrade broke boot of the Odroid C1. We do now pin, in case downgrade, and set on hold "current" and "edge" kernel packages of Armbian to v23.02.2 (Linux 5.15.93 respectively 6.1.11) with this DietPi update, which are the latest known functional packages for this SBC. Many thanks to [@oskar242000](https://dietpi.com/forum/u/oskar242000){: class="nospellcheck"} for reporting this issue: <https://dietpi.com/forum/t/odroid-c1-not-booting-after-kernel-upgrade/17818>
+- **Bookworm** :octicons-arrow-right-16: Resolved an issue where poweroff/reboot/halt commands did throw errors about missing `dbus` or `logind`. DietPi ships without `dbus` and with `logind` masked by default, as we do not see their features being used on a typical DietPi system. Instead, `dbus` is installed and `logind` unmasked on demand on certain software installs or when chosen via `dietpi.txt`. However, the newer `systemd` version since Bookworm attempts `dbus` > `logind` communication in any case when calling poweroff/reboot/halt, despite no wall message being sent, e.g. to handle shutdown inhibitors (like open SSH session being able to prevent shutdown), and throws errors if either `dbus` is not reachable or `logind` not running. Until in case `dbus` or `logind` are further tied into common system commands or features, we solved the issue by creating shell functions for poweroff/reboot/halt which call the respective systemd target directly to bypass `logind` (and hence `dbus`), but fall back to the original commands, depending on given command-line parameters.
+- **dietpi-bookworm-upgrade** :octicons-arrow-right-16: Resolved an issue on systems with Armbian repository, where the system was still identified as Bullseye after the distribution upgrade to Bookworm. Reason was Armbian's base-files package, which was not upgraded as intended. On all DietPi systems, the original base-files package from Debian will now be enforced to prevent this and similar issues. Many thanks to @rogerthn2019 for reporting this issue: <https://github.com/MichaIng/DietPi/issues/6227#issuecomment-1713688577>
+- [**DietPi-Tools**](../../dietpi_tools/) | [**DietPi-Config**](../../dietpi_tools/system_configuration/#dietpi-config) :octicons-arrow-right-16: The menu option to update the SPI bootloader is now shown on Orange Pi 5 Plus as well, as intended. Many thanks for @zappydood for reporting its absence: <https://github.com/MichaIng/DietPi/issues/6501#issuecomment-1697175109>
+- [**DietPi-Software**](../../dietpi_tools/software_installation/#dietpi-software) | [**Ampache**](../../software/media/#ampache) :octicons-arrow-right-16: Resolved an issue where the latest version was not successfully detected on install, so that an older fallback version was installed instead. Many thanks to @bartolus39 for reporting this issue: <https://github.com/MichaIng/DietPi/issues/6598>
+- [**DietPi-Software**](../../dietpi_tools/software_installation/#dietpi-software) | [**Bazarr**](../../software/bittorrent/#bazarr) :octicons-arrow-right-16: Resolved an issue where the installation failed on ARMv6 and ARMv7 Bullseye and Bookworm systems, since some pre-compiled Python modules are currently not available on piwheels, due to the currently running prioritised builds of all modules for Bookworm.
+
+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/6626>

docs/software.md

@@ -111,6 +111,7 @@ description: Overview of ready-to-run DietPi-Software options, cloud & backup se
 - [**Tor Relay - Add a node to the Tor network**](distributed_projects/#tor-relay)
 - [**YaCy - Decentralized open source search engine**](distributed_projects/#yacy)
 - [**IPFS Node - Contribute to a decentralized internet**](distributed_projects/#ipfs-node)
+- [**ADS-B Feeder - track airplanes using SDRs and feed the data to ADS-B aggregators**](distributed_projects/#ads-b-feeder)
 
 ## [DNS Servers](dns_servers/)
 
@@ -201,6 +202,7 @@ description: Overview of ready-to-run DietPi-Software options, cloud & backup se
 - [**Snapcast Server - Multi room audio server**](media/#snapcast-server)
 - [**Snapcast Client - Multi room audio client**](media/#snapcast-client)
 - [**Navidrome - Web interface media streaming server**](media/#navidrome)
+- [**Kavita - Open source comics/mangas/ebooks media server**](media/#kavita)
 
 ## [Printing Server](printing/)
 

docs/software/distributed_projects.md

@@ -11,6 +11,7 @@ description: Description of DietPi software options related to distributed softw
 - [**Tor Relay - Add a node to the Tor network**](#tor-relay)
 - [**YaCy - Decentralized open source search engine**](#yacy)
 - [**IPFS Node - Contribute to a decentralized internet**](#ipfs-node)
+- [**ADS-B Feeder - track airplanes using SDRs and feed the data to ADS-B aggregators**](#ads-b-feeder)
 
 ??? info "How do I run **DietPi-Software** and install **optimised software** items?"
     To install any of the **DietPi optimised software items** listed below run from the command line:
@@ -213,4 +214,42 @@ Official documentation: <https://docs.ipfs.io>
 !!! warning "Do not expose to internet"
     The IPFS web interface requires no authentication to use. Do not expose it to the internet without taking proper security measures, like an authenticated reverse proxy, VPN or similar.
 
+## ADS-B Feeder
+
+[ADSB.im](https://adsb.im/home/){: class="nospellcheck"} is a project to create an easy to manage [ADS-B Feeder system](https://wikipedia.org/wiki/Automatic_Dependent_Surveillance–Broadcast).  
+The images available as [GitHub Releases](https://github.com/dirkhh/adsb-feeder-image/releases) are intended to be run on dedicated Single Board Computers (or VMs) - many of them are actually based on DietPi. But if you already have a DietPi system that you use for other purposes, it might make more sense to simply add the software stack to your existing setup - and this is the purpose of providing ADS-B feeder as an app in the DietPi *Optimised Software list*.
+
+![A view of the planes around you](../assets/images/TAR1090-view.png){: width="400" height="403" loading="lazy"}
+
+What is ADS-B? Automatic Dependent Surveillance - Broadcast (ADS-B) is a surveillance technology that uses satellite navigation or other sensors to determine an aircraft's position and periodically broadcast it, enabling it to be tracked. With a simple (and relatively cheap) Software Defined Radio (SDR) USB stick, anyone can receive the ADS-B signal from planes in their vicinity. There are thousands of people all over the world who are tracking planes around them and then feed that data to sites that aggregate this data and make it available for others to use. Some of them, like [ADSB.lol](https://adsb.lol){: class="nospellcheck"}, do so under an open data license, others, like [FlightAware](https://www.flightaware.com/) are commercial companies that then resell the data to their customers.
+
+The ADS-B Feeder application allows you to feed any (or all) of these aggregators, currently almost two dozen.
+
+=== "Access to the web interface"
+
+    The web interface is accessible via the port **1099**, e.g. this could be:
+
+    - URL = `http://<your.IP>:1099`
+
+    The color of the plane icons is an indication of their altitude, lots more information (like call signs, routes of the planes, etc) are available as well. The system provides you with statistics, graphs, and information about the performance of your feeder, and makes it easy to explore some of the information provided by the aggregators that you are feeding.
+
+=== "Initial setup"
+
+    First of all, you need to connect an SDR to your system (lots more information at the [ADSB.im](https://adsb.im/howto){: class="nospellcheck"} [pages](https://adsb.im/supported) - currently these pages are somewhat focused on the full feeder images, but all of the other information applies here as well), add an antenna and set up the software.  
+    Then simply connect with a browser to your DietPi system on port 1099. On the initial setup page enter a name for your site plus its location and pick how you want to decide which aggregators to feed.
+
+    ![ADS-B Feeder Setup Page](../assets/images/ADSB-Feeder-Setup-Page.png){: width="500" height="343" loading="lazy"}
+
+    It will take a short while to get started (depending on your system and network speed as it will download a couple Docker containers), and after that you are up and running.
+
+    There are additional options for more advanced features, but even with just the information on the first page you'll already start tracking planes around you. Click on the **TAR1090 map** link on the feeder home page to see the planes around you.
+
+=== "Hardware requirements"
+
+    While this has been tested and works with 512MB of RAM, 1GB is a much more reasonable minimum. There seems to be no real benefit from having more than 2GB of RAM.  
+    Decoding the data streams from the SDR is somewhat CPU intensive. A simple rule of thumb is that you want one more core than you have SDRs. So for a typical setup with one SDR for ADS-B signals (sent at 1090 MHz), two cores are sufficient. If you are in the US and also want to scan for UAT traffic ("Universal Access Transceiver" sent at 978 MHz) and therefore have two SDRs connected, three cores will get you better results.
+
+Official documentation: <https://adsb.im/home>  
+Wikipedia page about ADS-B: <https://wikipedia.org/wiki/Automatic_Dependent_Surveillance–Broadcast>
+
 [Return to the **Optimised Software list**](../../software/)

docs/software/gaming.md

@@ -146,7 +146,7 @@ MineOS allows you to create multiple Minecraft servers with ease, using a simple
 
 ***
 
-Official forum: <https://discourse.codeemo.com/>  
+[//]: # (Currently not available: Official forum: <https://discourse.codeemo.com/>)
 Source code: <https://github.com/hexparrot/mineos-node>  
 License: [GPLv3](https://github.com/hexparrot/mineos-node/blob/master/LICENSE.md)
 

docs/software/media.md

@@ -40,6 +40,7 @@ description: Description of DietPi software options related to media systems lik
 - [**Snapcast Server - Multi room audio server**](#snapcast-server)
 - [**Snapcast Client - Multi room audio client**](#snapcast-client)
 - [**Navidrome - Web interface media streaming server**](#navidrome)
+- [**Kavita - Open source comics/mangas/ebooks media server**](#kavita)
 
 ??? info "How do I run **DietPi-Software** and install **optimised software** items?"
     To install any of the **DietPi optimised software items** listed below run from the command line:
@@ -1854,4 +1855,14 @@ Website: <https://www.navidrome.org/>
 Source code: <https://github.com/navidrome/navidrome>  
 License: [GPLv3](https://github.com/navidrome/navidrome/blob/master/LICENSE)
 
+## Kavita
+
+T.b.d.
+
+***
+
+Website: <https://www.kavitareader.com/>  
+Documentation: <https://wiki.kavitareader.com/en>  
+Source code: <https://github.com/Kareadita/Kavita>
+
 [Return to the **Optimised Software list**](../../software/)

mkdocs.yml

@@ -141,6 +141,7 @@ nav:
   - Miscellaneous Tools: dietpi_tools/misc_tools.md
 - RELEASES:
   - Overview: releases.md
+  - v8.22 September 2023: releases/v8_22.md
   - v8.21 August 2023: releases/v8_21.md
   - v8.20 July 2023, vol 2: releases/v8_20.md
   - v8.19 July 2023: releases/v8_19.md