Table of Contents

An index of every layer shipped with rpi-image-gen, grouped by category. Select a layer to see its attributes, variables, dependencies, hooks and overlays.

For an explanation of what layers are, how they are composed and the metadata they declare, see Layer Documentation.

Layer Library

audit

sbom-base- SBOM provider and settings.

base

embedded-svelte- Excludes manpages, locales, and docs to minimise image size.
embedded-svelte-static- Extends embedded-svelte by removing apt directories, for images that will never run apt in the field.
fs-base- Filesystem base properties and tunables. Provides per-filesystem-type configuration consumed by…
linux-base- Linux kernel base properties. Provides kernel level attributes that may influence downstream…

build

artefact-base- Base artefact naming, versioning and organisation for filesystem builds.
deploy-base- Deployment and organisation for build output artefacts
sys-build-base- Build environment configuration including workspace, apt settings, and system foundation defaults.
target-config- bdebstrap output target configuration.

ci

rpios-ci-container-policy- Apt and dpkg policy for container images used to build and test Debian packages for Raspberry Pi…

connectivity

bluez- BlueZ Bluetooth stack
bluez-obex- BlueZ OBEX daemon for Bluetooth file transfer
iwd- iNet wireless daemon for wifi management
network-manager- NetworkManager for wired and wireless network management
network-manager-iwd- NetworkManager with iwd as the wifi backend, NM managing connections and auto-connect
wireless-debug- Wireless diagnostic tools
wireless-regulatory- Wireless regulatory database
wireless-utils- Production wireless utilities

container

docker-debian-bookworm- Docker engine and framework for Debian Bookworm
docker-debian-trixie- Docker engine and framework for Debian Trixie

device

device-base- Device base layer and defaults
device-user-admin- Base layer for local user account provisioning. Creates user accounts, sets credentials, group…
device-user-credentials- Variable definitions for device user account configuration. Declares user account settings:…
rpi-ab-slot-mapper- Dynamic slot device management for A/B boot: udev rules and helpers that create stable by-slot…
rpi-cm4- Raspberry Pi CM4 specific device layer
rpi-cm5- Raspberry Pi CM5 specific device layer
rpi-device-base- Raspberry Pi device base layer and defaults
rpi-generic64- Generic Raspberry Pi device common with v8 kernel, boot firmware supporting all devices, and…
rpi-idp- Image Description Provisioning (IDP) configuration for Raspberry Pi devices.
rpi-idp-luks2- Device specific LUKS2 provisioning attributes for IDP. A device layer may use these to describe…
rpi-splash-screen- Raspberry Pi fullscreen splash screen support with custom image configuration.
rpi-storage-binder- Boot-device membership tagging for partitions and DM devices backed by the boot storage device,…
rpi3- Raspberry Pi 3 specific device layer
rpi4- Raspberry Pi 4 specific device layer
rpi5- Raspberry Pi 5 specific device layer
rpizero2w- Raspberry Pi Zero 2 W specific device layer

distribution

debian-bookworm-arm64- Debian Bookworm apt base for arm64
debian-bookworm-arm64-multi- Debian Bookworm apt base for arm64 and armhf.
debian-bookworm-arm64-slim- Debian Bookworm custom layer for arm64 providing a usable and practical base.
debian-bookworm-buildd- Architecture agnostic Debian Bookworm buildd base. This provides a base layer specifically…
debian-trixie-arm64- Debian Trixie apt base for arm64.
debian-trixie-arm64-minbase-rolling- Switches the Debian Trixie minbase snapshot to rolling repositories.
debian-trixie-arm64-minbase-snapshot- Debian Trixie minbase for arm64 using a snapshot mirror.
debian-trixie-arm64-multi- Debian Trixie apt base for arm64 and armhf.
debian-trixie-arm64-multi-minbase- Debian Trixie multi-arch base for interactive systems. No apt or dpkg restrictions - recommended…
debian-trixie-arm64-slim- Debian Trixie custom layer for arm64 providing a usable and practical base.
debian-trixie-buildd- Architecture agnostic Debian Trixie buildd base. This provides a base layer specifically designed…
raspbian-bookworm-armhf- Raspbian Bookworm apt base for armhf.
raspbian-trixie-armhf- Raspbian Trixie apt base for armhf.
rpi-microboot-base- Microboot filesystem base plus tooling hooks to pack a minimal filesystem into a single directory…

firmware

rpi-boot-firmware- Raspberry Pi boot firmware for all devices

foundation

essential- Serves as the mandatory foundation for all rpi-image-gen builds, and is automatically included in…
locale-config- Localisation and Internationalisation config settings

general

ca-certificates- Common CA Certificate PEM files
chrony- Chrony NTP client and server https://chrony-project.org
fake-hwclock- Persistent time management for non-RTC systems.
openssh-server- OpenSSH server daemon and local user SSH key setup. No SSH keys are installed by default. A…
rpi-debian-bookworm- Raspberry Pi Debian Bookworm APT repository
rpi-debian-trixie- Raspberry Pi Debian Trixie APT repository
rpi-essential-base- Raspberry Pi essential basic system packages
rpi-misc-skel- Raspberry Pi miscellaneous filesystem directory skeleton.
rpi-misc-utils- Raspberry Pi system utilities
systemd-min- Core systemd components for init and SysV compatibility, without additional services
systemd-net-min- Systemd networking via networkd and resolved services
systemd-resolved- systemd's built-in DNS client
systemd-timesyncd- systemd's built-in NTP client

i18n

locale-base- Pre-seeded locale and internationalisation settings
locale-gen- Installs and generates locales at build time

image

image-base- Default image settings and build attributes.
image-bootfs- Packs /bootfs directly into a FAT filesystem image. No partition table. For boot media that's…
image-rota- Immutable GPT A/B layout for rotational OTA updates, boot/system redundancy, and a shared…
image-rpios- Raspberry Pi OS style image layout with MBR, vfat boot partition, and a root partition that can…

kernel

rpi-linux-2712- Raspberry Pi 2712 kernel
rpi-linux-v7- Raspberry Pi v7 kernel
rpi-linux-v7l- Raspberry Pi v7l kernel
rpi-linux-v8- Raspberry Pi v8 kernel

security

rpi-device-secpolicy- Raspberry Pi device family security policy baseline

service

rpi-connect- Raspberry Pi Connect client with screen-sharing support and remote shell access
rpi-connect-lite- Raspberry Pi Connect client with remote shell access
rpi-connect-ota- Configures Raspberry Pi Connect's experimental remote update capability

suite

bookworm-minbase- Debian Bookworm with apt, utils, wired networking, ssh.
trixie-minbase- Debian Trixie with apt, utils, wired and wifi networking, ssh.

toolchain

arm64-toolchain-cross- ARM64 cross-compilation toolchain
arm64-toolchain-native- ARM64 native compilation toolchain
autotools-base- Autotools build environment
build-user- Environmental setup for dedicated build user
debian-dev-tools- Debian package development and maintenance tools
gnu-common- Common GNU toolchain setup with ccache and environment
kbuild-base- Linux kernel build environment with Debian packaging support.