Merge branch 'master' of 88.198.237.222:/git/m1-debian

[m1-debian] / README.md

diff --git a/README.md b/README.md
index 8e1519ac0956c6cbe93c2a065e0a8fca8a01b52c..745e6c3ad4a55b33089f4530b2c3c0ec3ba5fef1 100644 (file)
--- a/README.md
+++ b/README.md
@@ -2,14 +2,20 @@ This pages explains how to install Debian on Apple Silicon machines.
 
 # Tripwires
 The USB-A Port on the Mac Mini will not work in u-boot and grub.  The two
-additional USB-3 ports on the iMac 4 port model also don't work in u-boot, grub
+additional USB-3 ports on the iMac 4 port model don't work in u-boot, grub
 and Linux. In order to install Linux on a FileVault-enabled Mac run the
 installer from Recovery open Disk Utility > Expanding "Macintosh HD" >
-Selecting locked volume > click "Mount".
+Selecting locked volume > click "Mount". Debian does not include the choosen
+EFI patch. As a result it will always pick the first ESP partition. This can be
+problematic if you're using multiple ESP partitions for example when having
+multiple Linux and BSD installations.
 
 # Artefacts
 If you don't want to use the prebuild artefacts, you can build them yourself using the [bootstrap.sh](https://git.zerfleddert.de/cgi-bin/gitweb.cgi/m1-debian/blob_plain/refs/heads/master:/bootstrap.sh) script.
 
+# Kernel header files
+The kernel header files can be found here: <https://thomas.glanzmann.de/asahi/>
+
 # Asahi installer
 
 [Video Recording](https://tg.st/u/debian_asahi_installer.mp4)
@@ -41,6 +47,7 @@ If you don't want to use the prebuild artefacts, you can build them yourself usi
 
 * Install a desktop environment for example blackbox
 
+        apt-get update
         apt-get install -y xinit blackbox xterm firefox-esr lightdm
 
 * Create yourself an unprivileged user
@@ -56,11 +63,13 @@ If you don't want to use the prebuild artefacts, you can build them yourself usi
 * Consult the **[/root/quickstart.txt](https://git.zerfleddert.de/cgi-bin/gitweb.cgi/m1-debian/blob_plain/refs/heads/master:/files/quickstart.txt)** file to find out how to do other interesting things.
 
 # Livesystem
+
 [Video Recording](https://tg.st/u/live.mp4)
+
 * Prerequisites
 
         - USB Stick. this is what this guide assumes, but it is also possible
-          to run the Debian installer from another PC using m1n1 chainloading.
+          to run the Debian livesystem from another PC using m1n1 chainloading.
           But if you know how to do that, you probably don't need this guide.
         - If possible use an Ethernet Dongle, less typing.
 
@@ -68,14 +77,13 @@ If you don't want to use the prebuild artefacts, you can build them yourself usi
 
         # Identify the usb stick device
         lsblk
+
         DEVICE=/dev/sdX
         parted -a optimal $DEVICE mklabel msdos
         parted -a optimal $DEVICE mkpart primary fat32 2048s 100%
         mkfs.vfat ${DEVICE}1
-
-        mount /dev/sdX1 /mnt
-        cd /mnt
-        curl -sL https://tg.st/u/asahi-debian-live.tar | tar -xf -
+        mount ${DEVICE}1 /mnt
+        curl -sL https://tg.st/u/asahi-debian-live.tar | tar -C /mnt -xf -
         umount /mnt
 
 In order to format the usb stick under Macos, open the disk utility, right-click on the usb stick (usually the lowest device in the list) and select erase. Choose the following options:
@@ -92,7 +100,7 @@ Than open a terminal, and run the following commands:
 
 * You need to run the asahi installer and have either an OS installed or m1n1+UEFI.
 
-* If you have a EFI binary on the NVMe and want to boot from the usb stick, you need to interrupt u-boot on the countdoun by pressing any key and run the following comamnd to boot from usb:
+* If you have a EFI binary on the NVMe and want to boot from the usb stick, you need to interrupt u-boot on the countdown by pressing any key and run the following comamnd to boot from usb:
 
         run bootcmd_usb0