Recovery package

New Linux releases for the VisionBox are provided as recovery packages. A recovery package is a ZIP file which contains the Linux image (tar.gz) and a script for installing the images.

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.

The recovery packages and tar.gz images provided by IMAGO have a unique version number which is part of the file name.

Example:

Recovery package:	`Linux_Recovery_deb13_agex_v1.0_a.tar.gz`
Image file:	`deb13_agex_v1.0_a.tar.gz`

	`deb13`	→ Debian 13
	`agex`	→ Target device: VisionBox AGE-X
	`v1.0`	→ Image version (see page Release Notes)
	`a`	→ Image configuration (see page Image configurations)

Note: New Linux releases can be found at the IMAGO Download Portal (register here).

Installation script

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

Starting with Debian 13, the script automatically prepares the system for Secure Boot if supported by the hardware. A unique Machine Owner Key is created and enrolled for each system to support third-party kernel modules, see Enrolling the DKMS Machine Owner Key.

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 nvme0n1 deb13_agex_v1.0_a.tar.gz

Note

All existing data on the target device will be lost.