sd-card-images/README.md

46 lines
2.0 KiB
Markdown

# Debian SD card images
This repository is a bunch of scripts to build SD card images that various [single-board computers](https://en.wikipedia.org/wiki/Single-board_computer) (SBC) can boot. Emphasis is on pureness; pure Debian and pure mainline U-boot.
## Pre-built images
Pre-built images ready for download are availble at [sd-card-images.johang.se](https://sd-card-images.johang.se).
## Usage
The generated SD card images are made up of two separate images:
* **boot-BOARD.bin**: Boot image that contains partition table, U-Boot and chip-specific code. The boot image will only work on the board it's built for. The filename indicates which board it's built for.
* **debian-ARCH-VERSION-PASSWORD.bin**: Debian ext4 root filesystem image that contains a complete Debian installation, including kernel, initrd and device tree. This Debian image is generic and will work on all chips and boards with the CPU architecture it's built for. The filename indicates Debian version, CPU architecture and default root password.
These two images are the concatenated to a single image, which is then written to SD card, for example like this:
$ zcat boot-raspberrypi_2b.bin.gz debian-stretch-armhf-XXXXXX.bin.gz > sd-card.img
# dd if=sd-card.img of=/dev/sdXXX
<!--
### Build a boot image
To build a boot image for Raspberry Pi 3B:
git clone https://github.com/johang/debian-sd-card-images.git debian-sd-card-images
cd sd-images
docker build -t sd-images .
mkdir -p /tmp/sd-images
docker run --rm -v /tmp/sd-images:/artifacts sd-images boot raspberrypi_3b
Image will end up in /tmp/sd-images on the host.
### Build a Debian ext4 root filesystem image
To build a Debian image for arm64:
git clone https://github.com/johang/debian-sd-card-images.git debian-sd-card-images
cd sd-images
docker build -t sd-images .
mkdir -p /tmp/sd-images
docker run --rm -v /tmp/sd-images:/artifacts sd-images debian arm64 stretch
Image will end up in /tmp/sd-images on the host.
-->