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
-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 Trixie
-# 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.
+Please use the semi official Debian installer from now on:
-# Asahi installer
+```
+curl -sL https://bananas-archive.debian.net/install | sh
+```
-[Video Recording](https://tg.st/u/debian_asahi_installer.mp4)
+[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)
-* Poweroff your Mac. Hold and press the power button until you see a wheel chain and Options written below. Approx 20 seconds.
+If you need help, join us on irc.oftc.net in channel #debian-bananas. If you never used IRC, use the [OFTC Webchat](https://webchat.oftc.net/).
+[You can also join our mailing list](https://lists.debian.org/debian-arm-apple/).
-* In the boot picker, choose Options. Once loaded, open a Terminal under Utilities > Terminal
+# Debian ARM Applle Mailinglist
-* Run the asahi installer and select Debian:
+There is a [mailinglist](https://lists.debian.org/debian-arm-apple/).
- curl -sL https://tg.st/d | sh
+# Documentation is now in the Debian wiki:
-* Follow the installer instructions.
+[InstallingDebianOnAppleM1](https://wiki.debian.org/InstallingDebianOn/Apple/M1)
-* 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 install -y xinit blackbox xterm firefox-esr lightdm
-
-* Create yourself an unprivileged user
-
- useradd -m -c 'Firstname Lastname' -s /bin/bash <username>
- passwd <username>
-
-* 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 /dev/sdX1 /mnt
- cd /mnt
- curl -sL https://tg.st/u/asahi-debian-live.tar | tar -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.
projects / m1-debian / blobdiff