Initial commit

README.md

@@ -0,0 +1,41 @@
+# Raspberry Pi 3 image spec
+
+This repository contains the files with which the image referenced at
+https://wiki.debian.org/RaspberryPi3 has been built.
+
+## Option 1: Downloading an image
+
+See https://wiki.debian.org/RaspberryPi3#Preview_image for where to obtain the latest pre-built image.
+
+## Option 2: Building your own image
+
+If you prefer, you can build a Debian buster Raspberry Pi 3 image using:
+
+```shell
+git clone --recursive https://github.com/Debian/raspi3-image-spec
+cd raspi3-image-spec
+sudo ./vmdb2/vmdb2 --output raspi3.img raspi3.yaml --log raspi3.log
+```
+
+## Installing the image onto the Raspberry Pi 3
+
+Plug an SD card which you would like to entirely overwrite into your SD card reader.
+
+Assuming your SD card reader provides the device `/dev/sdb`, copy the image onto the SD card:
+
+```shell
+sudo dd if=raspi3.img of=/dev/sdb bs=5M
+```
+
+Then, plug the SD card into the Raspberry Pi 3 and power it up.
+
+The image uses the hostname `rpi3`, so assuming your local network correctly resolves hostnames communicated via DHCP, you can log into your Raspberry Pi 3 once it booted:
+
+```shell
+ssh root@rpi3
+# Enter password “raspberry”
+```
+
+## Reproducibility
+
+The image currently uses http://snapshot.debian.org/archive/debian/20171007T213914Z/ for ensuring a reproducible build.