Installing Debian

1 files changed, 46 insertions, 0 deletions

diff --git a/olpc-xo.rst b/olpc-xo.rst
index 0b99065..604d91d 100644
--- a/olpc-xo.rst
+++ b/olpc-xo.rst
@@ -97,3 +97,49 @@ the device name, you're ready to install Fedora::
 
 Once your machine is unlocked, it will automatically boot from your media
 wherever it will detect it attached to the USB bus or the SD card slot.
+
+Installing Debian
+-----------------
+
+Starting with December 2020 debian-installer nightlies, Debian produces
+install images for the OLPC XO-1.75 laptops. Debian installer can be
+started from a USB device or a SD card that can be prepared in the usual way.
+The target you install Debian to can also be a USB device, a SD card, or the
+internal eMMC.
+
+If you haven't installed Debian before you may find the full installation
+manual at https://d-i.debian.org/manual/en.armhf/index.html helpful.
+
+For a network installation you'll need a USB ethernet adapter and some
+files from
+`netboot/SD-card-images/ <http://ftp.debian.org/debian/dists/sid/main/installer-armhf/current/images/netboot/SD-card-images/>`_.
+Apparently, you can also do an offline image by placing an appropriate
+Debian ISO image on the install media and the installation using files from
+`hd-media/SD-card-images/ <http://ftp.debian.org/debian/dists/sid/main/installer-armhf/current/images/hd-media/SD-card-images/>`_.
+I'm going to assume you're doing a network install because ISO images of
+Arm nightlies don't seem to be produced and an online installation is
+probably more convenient anyway.
+
+Basically you just need to get
+`firmware.OLPC_XO.img.gz <http://ftp.debian.org/debian/dists/sid/main/installer-armhf/current/images/hd-media/SD-card-images/firmware.OLPC_XO.img.gz>`_
+and `partition.img.gz <http://ftp.debian.org/debian/dists/sid/main/installer-armhf/current/images/netboot/SD-card-images/partition.img.gz>`_,
+uncompress them and concatenate them to your install media.  You can read
+more on that in
+`README.concatenateable_images <http://ftp.debian.org/debian/dists/sid/main/installer-armhf/current/images/netboot/SD-card-images/README.concatenateable_images>`_.
+
+Here's how you'd go about doing it, assuming your install media is ``sdx``.
+The process destroys all data on the target volume, so make sure you pick
+the right one. ``lsblk`` command might help you identify the right volume::
+
+  # wget http://ftp.debian.org/debian/dists/sid/main/installer-armhf/current/images/hd-media/SD-card-images/firmware.OLPC_XO.img.gz
+  # gunzip firmware.OLPC_XO.img.gz
+  # wget http://ftp.debian.org/debian/dists/sid/main/installer-armhf/current/images/netboot/SD-card-images/partition.img.gz
+  # gunzip partition.img.gz
+  # cat firmware.OLPC_XO.img partition.img >/dev/sdx
+  #
+
+That's it, really. Once your machine is unlocked, it will automatically boot
+from your install media wherever it will detect it attached to the USB bus
+or the SD card slot.
+
+Once Debian is installed, it will be booted automatically as well.