X-Git-Url: http://cvs.zerfleddert.de/cgi-bin/gitweb.cgi/m1-debian/blobdiff_plain/47b13fcc06f24ef711192dcf73b22247b9407c73..a269d40abfa81620f4fccb341f14c5e8851eabb8:/README.md diff --git a/README.md b/README.md index 745e6c3..c8cd6ca 100644 --- a/README.md +++ b/README.md @@ -1,138 +1,14 @@ -This pages explains how to install Debian on Apple Silicon machines. +# Debian Trixie on M1/M2 Apple silicon -# 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 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". 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. +Please use the semi official Debian installer from now on: -# 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. +``` +curl -sL https://bananas-archive.debian.net/install | sh +``` -# Kernel header files -The kernel header files can be found here: +- [Due to a upstream bug, on M2 systems the USB-A Ports don't work in u-boot/grub. Use an USB-C keyboard, hub or dongle to connect your keyboard.](https://salsa.debian.org/bananas-team/wip/debian-asahi-image/-/issues/12) +- If you need help, join us on irc.oftc.net in channel #debian-bananas, also reachable via matrix. If you never used IRC, you can use the [OFTC Webchat](https://webchat.oftc.net/). +- [You can also join our mailing list](https://lists.debian.org/debian-arm-apple/). The address is: [debian-arm-apple@lists.debian.org](mailto:debian-arm-apple@lists.debian.org] +- Documentation is in the Debian wiki: [InstallingDebianOnAppleM1](https://wiki.debian.org/InstallingDebianOn/Apple/M1) -# Asahi installer - -[Video Recording](https://tg.st/u/debian_asahi_installer.mp4) - -* Poweroff your Mac. Hold and press the power button until you see a wheel chain and Options written below. Approx 20 seconds. - -* In the boot picker, choose Options. Once loaded, open a Terminal under Utilities > Terminal - -* Run the asahi installer and select Debian: - - curl -sL https://tg.st/d | sh - -* Follow the installer instructions. - -* Once Debian is booted log in as root without password and set a root password - - passwd - pwconv - -* Configure wifi by editing the wpa_supplicant.conf, enabling the interface and remove the # before allow-hotplug to enable it during boot. - - vi /etc/wpa_supplicant/wpa_supplicant.conf - ifup wlp1s0f0 - vi /etc/network/interfaces - -* Reboot to see if grub was correctly installed - - reboot - -* 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 - - useradd -m -c 'Firstname Lastname' -s /bin/bash - passwd - -* Optional install sshd. You can not log in as root, but only with your unprivileged user - - apt update - apt install -y openssh-server - -* 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 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. - -* Create USB Stick with a single vfat partition on it and untar the modified Debian installer on it. Instructions for Linux: - - # 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 ${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: - - Name: LIVE - Format: MS-DOS (FAT) - Scheme: Master Boot Record - -Than open a terminal, and run the following commands: - - sudo su - - cd /Volumes/LIVE - curl -sL https://tg.st/u/asahi-debian-live.tar | tar -xf - - -* 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 countdown by pressing any key and run the following comamnd to boot from usb: - - run bootcmd_usb0 - -* Reboot with the USB stick connected, the Debian livesystem should automatically start, if it doesn't load the kernel and initrd manually, you can use tab. For x try 0,1,2,... - - linux (hdX,msdos1)/vmlinuz - initrd (hdX,msdos1)/initrd.gz - boot - -* Log in as **root** without password. - -* 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 get the networking up, etc. - -# FAQ - -* If I install Debian, will it still be relatively easy to update the Asahi work as it develops? - -Yes, long answer below. - -To update the kernel to the lastest "stable" asahi branch you need to run -as root: - - curl -sL https://tg.st/u/ksh | bash - -Later it might be necessary to upgrade the stub parition in order to -support the GPU code. As soon as that happens, I'll add the -instructions and a video in order to do so, but short version is: - - - Backup /boot/efi/EFI - - Delete the old stub and efi/esp partition - - Rerun the asahi installer with m1n1+u-boot option - - Put the /boot/efi/EFI back - -So, you never need to reinstall Debian. Kernel updates are easy, stub -updates are a little bit more cumbersome but also seldom. +The old README has been archived because it is outdated and can be found in the git history.