New Linux releases are provided as Recovery Packages. A recovery package contains the Linux image (tar.gz) and scripts for installing images.

Package contents

Recovery Package contents
File	Description
`helper/∗`	Files required by the installation scripts.
`html/∗`	This document, the most recent release is also available online
`∗.tar.gz`	Linux image: root file system as compressed tarball
`∗-elbe-report.txt`	Report file generated by the ELBE build system
`∗-license.txt`	Licenses of installed packages within the Linux image
`install.sh`	This Linux shell script can be used to install a new Linux file system directly to a device, e.g. USB stick or SSD.

Installation script

After extracting the recovery ZIP file, the executable flags for the Linux script have to be set:

unzip Linux_Recovery_*.zip
cd Linux_Recovery_*
chmod +x *.sh

The Linux shell script install.sh is used to install the Linux root file system on a storage device. Removable devices are also supported. The target system will be prepared to support legacy boot and EFI boot by default.

The script is controlled by using command line arguments:

install.sh [Options] <Image>

Options:

-d <device> → Target device for installation without leading '/dev/' (mandatory)
-g none|bios|efi|both → GRUB install mode, default: both
-h → Print help
-r → Install GRUB on a removable device (do not update boot entries using EFI variables)
-y → Say yes to all questions

The last argument is the .tar.gz image to install.

Example:

./install.sh -d sdc deb12_agex_v1.0_a.tar.gz

Note

All existing data will be lost.

The script creates a new GPT partition table on the target device using the following layout:

Partition layout
Partition	Type	Size	File system type	Mount point
1	BIOS boot	1 MB	-	-
2	EFI system	1 GB	vfat	/boot
3	Linux	remaining space	ext4	/