The boot folder
In a basic Raspberry Pi OS install, the boot files are stored on the first partition of the SD card, which is formatted with the FAT file system. This means that it can be read on Windows, macOS, and Linux devices.
When the Raspberry Pi is powered on, it loads various files from the boot partition/folder in order to start up the various processors, then it boots the Linux kernel.
Once Linux has booted, the boot partition is mounted as
Boot folder contents
This is the bootloader, which is loaded by the SoC on boot, does some very basic setup, and then loads one of the
bootcode.bin is not used on the Raspberry Pi 4, because it has been replaced by boot code in the onboard EEPROM.
start.elf, start_x.elf, start_db.elf, start_cd.elf, start4.elf, start4x.elf, start4cd.elf, start4db.elf
These are binary blobs (firmware) that are loaded on to the VideoCore in the SoC, which then take over the boot process.
start.elf is the basic firmware,
start_x.elf includes camera drivers and codec,
start_db.elf is a debug version of the firmware, and
start_cd.elf is a cut-down version with no support hardware blocks like codecs and 3D, and for use when
gpu_mem=16 is specified in
config.txt. More information on how to use these can be found in the
start4db.elf are firmware files specific to the Pi 4.
These are linker files and are matched pairs with the
start*.elf files listed in the previous section.
The kernel command line passed in to the kernel when it boots.
Contains many configuration parameters for setting up the Pi. See the
Some text-based housekeeping information containing the date and git commit ID of the distribution.
ssh or ssh.txt
When this file is present, SSH will be enabled on boot. The contents don't matter, it can be empty. SSH is otherwise disabled by default.
This is the file to configure wireless network settings (if the hardware is capable of it). Edit the country code and the network part to fit your case. More information on how to use this file can be found in the
Device Tree files
There are various Device Tree blob files, which have the extension
.dtb. These contain the hardware definitions of the various models of Raspberry Pi, and are used on boot to set up the kernel according to which Pi model is detected. More details here.
The boot folder will contain various kernel image files, used for the different Raspberry Pi models:
|Filename||Processor||Raspberry Pi model||Notes|
|kernel.img||BCM2835||Pi Zero, Pi 1|
|kernel7.img||BCM2836, BCM2837||Pi 2, Pi 3||Later Pi 2 uses the BCM2837|
|kernel7l.img||BCM2711||Pi 4||Large Physical Address Extension (LPAE)|
|kernel8.img||BCM2837, BCM2711||Pi 2, Pi 3, Pi 4||Beta 64 bit kernel1. Earlier Pi 2 with BCM2836 do not support 64-bit.|
1 Information on booting a 64-bit kernel can be found here.
Note: The architecture reported by
armv7l for 32-bit systems (i.e. everything except kernel8.img), and
aarch64 for 64-bit systems. The
l in the
armv7l case refers to the architecture being little-endian, not
LPAE as is indicated by the
l in the
Device Tree overlays
overlays sub-folder contains Device Tree overlays. These are used to configure various hardware devices that may be attached to the system, for example the Raspberry Pi Touch Display or third-party sound boards. These overlays are selected using entries in
config.txt — see 'Device Trees, overlays and parameters, part 2' for more info.