From 312b0d0d2e580ec938598e9df1992f8dd8819e1d Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Mon, 6 Feb 2023 13:58:43 +0200 Subject: [PATCH 01/12] Fix typo --- docs/distributions/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/distributions/overview.md b/docs/distributions/overview.md index 064f4486f..eaa706982 100644 --- a/docs/distributions/overview.md +++ b/docs/distributions/overview.md @@ -9,4 +9,4 @@ This is a landing page for the distribution specific guides contained in this wi - [Manjaro](https://wiki.t2linux.org/distributions/manjaro/home/) - [NixOS](https://wiki.t2linux.org/distributions/nixos/installation/) - [Ubuntu](https://wiki.t2linux.org/distributions/ubuntu/home/) -- [Debain, Linux Mint, Kali, Pop!_OS and other similar distros](https://wiki.t2linux.org/distributions/debian/installation/) +- [Debian, Linux Mint, Kali, Pop!_OS and other similar distros](https://wiki.t2linux.org/distributions/debian/installation/) From 90bd86be290185c51836c8f09864c86dd705e255 Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Mon, 6 Feb 2023 14:07:38 +0200 Subject: [PATCH 02/12] Initial fixup: (some) rephrasing --- docs/distributions/debian/installation.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index 58538c57c..8a81368ba 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -1,8 +1,8 @@ # Introduction -This guide shall help you in installing a Debian or Ubuntu based Linux distro, which is not available as a modified ISO with T2 support. +This guide shall help you in installing a Debian or Ubuntu-based Linux distro that does not have a modified ISO with T2 support. -Some popular distros include :- +Some popular distros include: 1. [Linux Mint](https://linuxmint.com/) 2. [Pop!_OS](https://pop.system76.com/) @@ -10,30 +10,30 @@ Some popular distros include :- 4. [Debian](https://www.debian.org/) 5. [Zorin OS](https://zorin.com/) 6. [Kali Linux](https://www.kali.org/) -7. Other Ubuntu flavours like [Kubuntu](https://kubuntu.org/), [Ubuntu unity](https://ubuntuunity.org/) etc. +7. Other Ubuntu flavours like [Kubuntu](https://kubuntu.org/), [Ubuntu Unity](https://ubuntuunity.org/) etc. # Hardware Requirements -* USB-C to USB adapter -* Wired internet connection (Ethernet/USB tethering) or Wi-Fi adapter compatible with Linux +* USB-C to USB-A adapter +* Internet connection - either wired (using an USB Ethernet dongle or USB tethering from a phone) or wireless (using a Linux-compatible Wi-Fi adapter) * External keyboard and mouse # Install Procedure -!!! Warning "Installation fails when installing the bootloader (Eg :- GRUB)" - It is possible that during installation, when the installer is installing the bootloader (GRUB in most cases), the installation may fail. This is because the distro's ISO is using an old Linux kernel which doesn't support writing to the NVRAM of T2 Macs. In such a case, boot into the ISO again. When the initial menu gets displayed having options to try/install the distro, press "e" on the option you otherwise would have chosen to install. This will open the command line. Add `efi=noruntime` to the command line and press "F10" to boot. This should fix the issue. +!!! Warning "Installation fails when installing the bootloader (e.g. GRUB)" + It is possible that during installation, when the installer is installing the bootloader (GRUB in most cases), that the installation may fail. This is because the distro's ISO is using an old Linux kernel which doesn't support writing to the NVRAM of T2 Macs. In such a case, boot into the ISO again. When the initial menu gets displayed having options to try/install the distro, press "e" on the option you otherwise would have chosen to install. This will open the command line. Add `efi=noruntime` to the command line and press "F10" to boot. This should fix the issue. !!! Warning "Pop!_OS" - Due to a bug in Pop!_OS installer, the partition sizes shown by it are incorrect during manual partitioning step. As a workaround you may follow the instructions given in this [GitHub issue](https://github.com/elementary/installer/issues/620#issuecomment-1356978490) in the live ISO environment to fix the installer and then start the installation. + Due to a bug in the Pop!_OS installer, the partition sizes shown by it are incorrect when using manual partitioning. As a workaround you may follow the instructions given in this [GitHub issue](https://github.com/elementary/installer/issues/620#issuecomment-1356978490) in the live ISO environment to fix the installer and then start the installation. -1. Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for installation. +1. Follow the [pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for installation. 2. Boot into the Live ISO. You should now be in the GRUB boot menu. Select the option which is relevent to you. 3. Start the installer and install it like normal until you get an option to manually specify partitions. 4. Find the partition you made for Linux when you were following the Pre-installation steps. MAKE SURE TO SELECT THE RIGHT PARTITION OR ELSE YOUR DATA WILL BE LOST. Delete it to make free space. You'll need to make these partitions: - 1. If you want, you can make seperate partitions for **swap**, `/home`, `/boot` etc as you do in a normal PC. + 1. If you want, you can make seperate partitions for **swap**, `/home`, `/boot` etc. as you would normally. - 2. The partition to be made compulsorily is the one mounted at `/` and formatted to **ext4** or **btrfs**. + 2. The partition you must make is the one mounted at `/` and formatted to **ext4** or **btrfs**. 3. If the installer used by your distro is `ubiquity`, which is the one used in Ubuntu, Linux Mint etc., then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). From 11ef21bfc6fc131fd2c15448f893b034517f41ac Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Mon, 6 Feb 2023 15:33:29 +0200 Subject: [PATCH 03/12] Fixup: rephrasing, correct some grammar, indicate what distros are based on --- docs/distributions/debian/installation.md | 64 ++++++++++++----------- 1 file changed, 34 insertions(+), 30 deletions(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index 8a81368ba..c9311a2c4 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -1,21 +1,21 @@ # Introduction -This guide shall help you in installing a Debian or Ubuntu-based Linux distro that does not have a modified ISO with T2 support. +This guide will help you in installing a Debian or Ubuntu-based Linux distro that does not have a modified ISO with T2 support. Some popular distros include: -1. [Linux Mint](https://linuxmint.com/) -2. [Pop!_OS](https://pop.system76.com/) -3. [elementary OS](https://elementary.io/) -4. [Debian](https://www.debian.org/) -5. [Zorin OS](https://zorin.com/) -6. [Kali Linux](https://www.kali.org/) -7. Other Ubuntu flavours like [Kubuntu](https://kubuntu.org/), [Ubuntu Unity](https://ubuntuunity.org/) etc. +* [Linux Mint](https://linuxmint.com/) (Ubuntu-based | Debian-based if using LMDE (Linux Mint Debian Edition)) +* [Pop!_OS](https://pop.system76.com/) (Ubuntu-based) +* [elementary OS](https://elementary.io/) (Ubuntu-based) +* [Debian](https://www.debian.org/) (Debian) +* [Zorin OS](https://zorin.com/) (Ubuntu-based) +* [Kali Linux](https://www.kali.org/) (Debian-based) +* Other Ubuntu flavours like [Kubuntu](https://kubuntu.org/), [Ubuntu Unity](https://ubuntuunity.org/) etc. (Ubuntu-based) -# Hardware Requirements +# Required Hardware * USB-C to USB-A adapter -* Internet connection - either wired (using an USB Ethernet dongle or USB tethering from a phone) or wireless (using a Linux-compatible Wi-Fi adapter) +* Internet connection - either **wired** (using an USB Ethernet dongle or USB tethering from a phone) or **wireless** (using a Linux-compatible Wi-Fi adapter) * External keyboard and mouse # Install Procedure @@ -26,68 +26,72 @@ Some popular distros include: !!! Warning "Pop!_OS" Due to a bug in the Pop!_OS installer, the partition sizes shown by it are incorrect when using manual partitioning. As a workaround you may follow the instructions given in this [GitHub issue](https://github.com/elementary/installer/issues/620#issuecomment-1356978490) in the live ISO environment to fix the installer and then start the installation. -1. Follow the [pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for installation. -2. Boot into the Live ISO. You should now be in the GRUB boot menu. Select the option which is relevent to you. -3. Start the installer and install it like normal until you get an option to manually specify partitions. -4. Find the partition you made for Linux when you were following the Pre-installation steps. MAKE SURE TO SELECT THE RIGHT PARTITION OR ELSE YOUR DATA WILL BE LOST. Delete it to make free space. You'll need to make these partitions: +1. Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for installation. +2. Boot into the Live ISO. In the GRUB boot menu, select the option relevant to you. +3. Start the installer and go through it like normal until you get to partitioning. Select the relevant option for **manual partitioning**. +4. **WARNING: MAKE SURE TO SELECT THE RIGHT PARTITION OR YOU MAY LOSE YOUR DATA.** Find the partition you made for Linux during the Pre-installation step and delete it to make free space. You'll need to make these partitions: - 1. If you want, you can make seperate partitions for **swap**, `/home`, `/boot` etc. as you would normally. + 1. You **must** create a **`/`** ("root") partition formatted as **ext4** or **btrfs**. - 2. The partition you must make is the one mounted at `/` and formatted to **ext4** or **btrfs**. + 2. You may opt to make separate partitions for **`/home`**, **`/boot`**, **swap** etc. as you would normally. - 3. If the installer used by your distro is `ubiquity`, which is the one used in Ubuntu, Linux Mint etc., then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). + 3. If `ubiquity` is the installer used by your distro (used in *Ubuntu*, *Linux Mint* and others), then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). - For other installers, you need to mount `nvme0n1p1`, or your [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions) (whatever case applies to you) at `/boot/efi`. If the installer supports the "boot" flag, set it as well for your EFI partition. + For other installers, you need to mount `nvme0n1p1`, or your [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions) (whatever case applies to you) at `/boot/efi`. If the installer supports the `boot` flag, set it as well for your EFI partition. -5. Continue the rest of the setup. -6. Once it's finished, you can reboot without your installation media. Hold down Option (⌥) while booting, then select EFI Boot and press enter. +5. Continue with the rest of the installation. +6. Once it's finished, reboot. You may remove your installation media. Hold down Option (⌥) while booting, then select EFI Boot and press enter. # Adding T2 support -After installation, we need to install a kernel having patches to support the T2 Macs for the internal keyboard, trackpad, touchbar, audio, Wi-Fi etc. to work. In order to do so :- +After installation, you need to install a kernel with patches with T2 support (needed for the internal keyboard, trackpad, touchbar, audio, Wi-Fi etc. to work). + +Steps: 1. Boot into your new installation. -2. Connect to the internet using Ethernet/USB tethering/external Wi-Fi adapter. +2. Connect to the internet using Ethernet / USB tethering / an external Wi-Fi adapter. + +3. Add the **t2-ubuntu-repo** apt repo by running -3. Add the **t2-ubuntu-repo** apt repo by running :- - ```bash curl -s --compressed "https://adityagarg8.github.io/t2-ubuntu-repo/KEY.gpg" | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/t2-ubuntu-repo.gpg >/dev/null + sudo curl -s --compressed -o /etc/apt/sources.list.d/t2.list "https://adityagarg8.github.io/t2-ubuntu-repo/t2.list" + sudo apt update ``` 4. Now install the kernel upgrade script. - * If your distro is Ubuntu based, run :- + * If your distro is Ubuntu-based, run: ```bash sudo apt install t2-kernel-script ``` - * If your distro is Debian based, run :- + * If your distro is Debian-based, run: ```bash sudo apt install t2-kernel-script-debian ``` -5. Then upgrade your kernel to a T2 kernel by running :- +5. Then upgrade your kernel to a T2 kernel by running: ```bash update_t2_kernel ``` -6. Install the audio configuration files by running :- +6. Install the audio configuration files by running: ```bash sudo apt install apple-t2-audio-config ``` - **Note :-** If your distro is using PulseAudio by default, consider switching to PipeWire as mentioned in the [audio guide](https://wiki.t2linux.org/guides/audio-config/#audio-configuration-files). + **Note:** If your distro is using PulseAudio by default, consider switching to PipeWire as mentioned in the [audio guide](https://wiki.t2linux.org/guides/audio-config/#audio-configuration-files). 7. Follow the [Wi-Fi guide](https://wiki.t2linux.org/guides/wifi-bluetooth/) to get internal Wi-Fi working. # Basic set up -After installing the new kernel, follow the [Basic setup](https://wiki.t2linux.org/guides/postinstall/) guide. You shall mainly have to follow the [Add necessary kernel parameters](https://wiki.t2linux.org/guides/postinstall/#add-necessary-kernel-paramaters) and [Make modules load on boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-boot) sections. If using disk encryption (LUKS), then follow the [Make modules load on early boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-early-boot) section as well. Rest have been set up automatically by the kernel upgrade script. +After installing the new kernel, follow the [Basic setup](https://wiki.t2linux.org/guides/postinstall/) guide. You mainly have to follow the [Add necessary kernel parameters](https://wiki.t2linux.org/guides/postinstall/#add-necessary-kernel-paramaters) and [Make modules load on boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-boot) sections. If using disk encryption (LUKS), then follow the [Make modules load on early boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-early-boot) section as well. The rest has been set up automatically by the kernel upgrade script. From 3e8c0541d95412198d5e8ff9831303ddd6dda0f4 Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Mon, 6 Feb 2023 21:13:06 +0200 Subject: [PATCH 04/12] Add longer title to this warning --- docs/distributions/debian/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index c9311a2c4..8a8821a0f 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -23,7 +23,7 @@ Some popular distros include: !!! Warning "Installation fails when installing the bootloader (e.g. GRUB)" It is possible that during installation, when the installer is installing the bootloader (GRUB in most cases), that the installation may fail. This is because the distro's ISO is using an old Linux kernel which doesn't support writing to the NVRAM of T2 Macs. In such a case, boot into the ISO again. When the initial menu gets displayed having options to try/install the distro, press "e" on the option you otherwise would have chosen to install. This will open the command line. Add `efi=noruntime` to the command line and press "F10" to boot. This should fix the issue. -!!! Warning "Pop!_OS" +!!! Warning "Pop!_OS incorrect partition sizes" Due to a bug in the Pop!_OS installer, the partition sizes shown by it are incorrect when using manual partitioning. As a workaround you may follow the instructions given in this [GitHub issue](https://github.com/elementary/installer/issues/620#issuecomment-1356978490) in the live ISO environment to fix the installer and then start the installation. 1. Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for installation. From 969781a778273c7be1e701c7bbaf0c354e6c3849 Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Mon, 6 Feb 2023 21:18:34 +0200 Subject: [PATCH 05/12] Fix style according to AdityaGarg8 --- docs/distributions/debian/installation.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index 8a8821a0f..ccc4244f6 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -21,21 +21,21 @@ Some popular distros include: # Install Procedure !!! Warning "Installation fails when installing the bootloader (e.g. GRUB)" - It is possible that during installation, when the installer is installing the bootloader (GRUB in most cases), that the installation may fail. This is because the distro's ISO is using an old Linux kernel which doesn't support writing to the NVRAM of T2 Macs. In such a case, boot into the ISO again. When the initial menu gets displayed having options to try/install the distro, press "e" on the option you otherwise would have chosen to install. This will open the command line. Add `efi=noruntime` to the command line and press "F10" to boot. This should fix the issue. + It is possible that during installation, when the bootloader (GRUB in most cases) is being installed, the installation may fail. This is because the distro's ISO is using an old Linux kernel which doesn't support writing to the NVRAM of T2 Macs. In such a case, boot into the ISO again. When the initial menu gets displayed having options to try/install the distro, press "e" on the option you otherwise would have chosen to install. This will open the command line. Add `efi=noruntime` to the command line and press "F10" to boot. This should fix the issue. !!! Warning "Pop!_OS incorrect partition sizes" Due to a bug in the Pop!_OS installer, the partition sizes shown by it are incorrect when using manual partitioning. As a workaround you may follow the instructions given in this [GitHub issue](https://github.com/elementary/installer/issues/620#issuecomment-1356978490) in the live ISO environment to fix the installer and then start the installation. 1. Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for installation. 2. Boot into the Live ISO. In the GRUB boot menu, select the option relevant to you. -3. Start the installer and go through it like normal until you get to partitioning. Select the relevant option for **manual partitioning**. +3. Start the installer and go through it like normal. Make sure to select **manual partitioning** instead of letting the installer automatically manage partitions for you! 4. **WARNING: MAKE SURE TO SELECT THE RIGHT PARTITION OR YOU MAY LOSE YOUR DATA.** Find the partition you made for Linux during the Pre-installation step and delete it to make free space. You'll need to make these partitions: 1. You **must** create a **`/`** ("root") partition formatted as **ext4** or **btrfs**. 2. You may opt to make separate partitions for **`/home`**, **`/boot`**, **swap** etc. as you would normally. - 3. If `ubiquity` is the installer used by your distro (used in *Ubuntu*, *Linux Mint* and others), then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). + 3. If `ubiquity` is the installer used by your distro (used by *Ubuntu*, *Linux Mint* and others), then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). For other installers, you need to mount `nvme0n1p1`, or your [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions) (whatever case applies to you) at `/boot/efi`. If the installer supports the `boot` flag, set it as well for your EFI partition. @@ -52,13 +52,11 @@ Steps: 2. Connect to the internet using Ethernet / USB tethering / an external Wi-Fi adapter. -3. Add the **t2-ubuntu-repo** apt repo by running +3. Add the **t2-ubuntu-repo** apt repo by running: ```bash curl -s --compressed "https://adityagarg8.github.io/t2-ubuntu-repo/KEY.gpg" | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/t2-ubuntu-repo.gpg >/dev/null - sudo curl -s --compressed -o /etc/apt/sources.list.d/t2.list "https://adityagarg8.github.io/t2-ubuntu-repo/t2.list" - sudo apt update ``` From db10c0bda9e2ce4a8cdf1221f959a16acc15d85a Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Mon, 6 Feb 2023 22:56:52 +0200 Subject: [PATCH 06/12] Use suggestion from AdityaGarg8 --- docs/distributions/debian/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index ccc4244f6..4ed7bb840 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -35,7 +35,7 @@ Some popular distros include: 2. You may opt to make separate partitions for **`/home`**, **`/boot`**, **swap** etc. as you would normally. - 3. If `ubiquity` is the installer used by your distro (used by *Ubuntu*, *Linux Mint* and others), then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). + 3. If `ubiquity` is the installer used by your distro (used by *Ubuntu*, *Linux Mint* and other similar distros), then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). For other installers, you need to mount `nvme0n1p1`, or your [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions) (whatever case applies to you) at `/boot/efi`. If the installer supports the `boot` flag, set it as well for your EFI partition. From ec49d809d67cbf2cb02621caca204706efdd39b3 Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Tue, 7 Feb 2023 18:34:18 +0200 Subject: [PATCH 07/12] No more double brackets --- docs/distributions/debian/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index 4ed7bb840..758cad9ac 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -4,7 +4,7 @@ This guide will help you in installing a Debian or Ubuntu-based Linux distro tha Some popular distros include: -* [Linux Mint](https://linuxmint.com/) (Ubuntu-based | Debian-based if using LMDE (Linux Mint Debian Edition)) +* [Linux Mint](https://linuxmint.com/) (Ubuntu-based | Debian-based if using LMDE) * [Pop!_OS](https://pop.system76.com/) (Ubuntu-based) * [elementary OS](https://elementary.io/) (Ubuntu-based) * [Debian](https://www.debian.org/) (Debian) From b117cc3d85f66797cb52fd09e005ed78e088c2e9 Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Tue, 7 Feb 2023 23:08:57 +0200 Subject: [PATCH 08/12] Add more info on the required hardware --- docs/distributions/debian/installation.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index 758cad9ac..f0bc0e254 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -15,9 +15,17 @@ Some popular distros include: # Required Hardware * USB-C to USB-A adapter + + May be required to connect various hardware (e.g. a wire to your phone, wireless Wi-Fi dongle etc.) + * Internet connection - either **wired** (using an USB Ethernet dongle or USB tethering from a phone) or **wireless** (using a Linux-compatible Wi-Fi adapter) + + Note that you will be able to setup internal Wi-Fi after you install and setup the T2 kernel. More on this later in the guide. + * External keyboard and mouse + Required as the internal keyboard and trackpad do not work without the T2 kernel. + # Install Procedure !!! Warning "Installation fails when installing the bootloader (e.g. GRUB)" From 02e5d8f401564f9743782a4754ea4fc14fe23bc0 Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Tue, 7 Feb 2023 23:11:37 +0200 Subject: [PATCH 09/12] Emphasize internal Wi-Fi is not available in the live ISO --- docs/distributions/debian/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index f0bc0e254..8eed68f02 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -20,7 +20,7 @@ Some popular distros include: * Internet connection - either **wired** (using an USB Ethernet dongle or USB tethering from a phone) or **wireless** (using a Linux-compatible Wi-Fi adapter) - Note that you will be able to setup internal Wi-Fi after you install and setup the T2 kernel. More on this later in the guide. + The internal Wi-Fi does not work without the T2 kernel. Note that you will be able to setup internal Wi-Fi after you install and setup the T2 kernel. More on this later in the guide. * External keyboard and mouse From 678d17da386c327b39a109a64cbe615e9ff119b9 Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Tue, 7 Feb 2023 23:27:29 +0200 Subject: [PATCH 10/12] Rework Installation section, attempting to make it more clear --- docs/distributions/debian/installation.md | 37 +++++++++++++++++------ 1 file changed, 27 insertions(+), 10 deletions(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index 8eed68f02..7887a3372 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -34,21 +34,38 @@ Some popular distros include: !!! Warning "Pop!_OS incorrect partition sizes" Due to a bug in the Pop!_OS installer, the partition sizes shown by it are incorrect when using manual partitioning. As a workaround you may follow the instructions given in this [GitHub issue](https://github.com/elementary/installer/issues/620#issuecomment-1356978490) in the live ISO environment to fix the installer and then start the installation. -1. Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for installation. -2. Boot into the Live ISO. In the GRUB boot menu, select the option relevant to you. -3. Start the installer and go through it like normal. Make sure to select **manual partitioning** instead of letting the installer automatically manage partitions for you! -4. **WARNING: MAKE SURE TO SELECT THE RIGHT PARTITION OR YOU MAY LOSE YOUR DATA.** Find the partition you made for Linux during the Pre-installation step and delete it to make free space. You'll need to make these partitions: +## Pre-installation + +* Follow the [Pre-installation](https://wiki.t2linux.org/guides/preinstall) steps to prepare your Mac for installation. +* Flash your chosen Debian or Ubuntu-based distro to a USB drive. + +## Installation + +1. **First steps** + 1. Boot into the Live ISO. In the GRUB boot menu, select the option relevant to you. + 2. Start the installer and go through it like normal. When you get the option to, make sure to select **manual partitioning**! (instead of letting the installer automatically manage partitions for you) + +2. **Partitioning** + + Find the partition you made for Linux during the Pre-installation step and delete it to make free space. (**WARNING:** ***MAKE SURE TO SELECT THE RIGHT PARTITION OR YOU MAY LOSE YOUR DATA.*** ) + + You will then need to follow these steps: 1. You **must** create a **`/`** ("root") partition formatted as **ext4** or **btrfs**. - 2. You may opt to make separate partitions for **`/home`**, **`/boot`**, **swap** etc. as you would normally. + 2. You may **optionally** make separate partitions for **`/home`**, **`/boot`**, **swap** etc. as you would normally. - 3. If `ubiquity` is the installer used by your distro (used by *Ubuntu*, *Linux Mint* and other similar distros), then you can leave EFI Boot alone. If you are using a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you shall have to separate it out after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). - - For other installers, you need to mount `nvme0n1p1`, or your [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions) (whatever case applies to you) at `/boot/efi`. If the installer supports the `boot` flag, set it as well for your EFI partition. + 3. If `ubiquity` is the installer used by your distro (used by *Ubuntu*, *Linux Mint* and other similar distros), then you can leave EFI Boot alone. If you are usiwant to use a [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions), then you have to separate it after installation by following [this guide](https://wiki.t2linux.org/guides/windows/#seperate-the-efi-partition-after-linux-is-installed). + + For other installers, you need to mount either `nvme0n1p1` **or** your [separate EFI partition](https://wiki.t2linux.org/guides/windows/#using-seperate-efi-partitions) at `/boot/efi`. If the installer supports the `boot` flag, set it as well for your EFI partition. + +3. **Continuing the installation** + + Continue with the rest of the installation. Once it successfully finishes, shutdown. You may remove your installation media. + +## Post-installation -5. Continue with the rest of the installation. -6. Once it's finished, reboot. You may remove your installation media. Hold down Option (⌥) while booting, then select EFI Boot and press enter. +Hold down Option (⌥) while booting, then select EFI Boot (make sure it has the internal disk icon) and press enter. # Adding T2 support From 98ac779d0fda852a9f38c7c9b2c76a7e9201d24b Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Tue, 7 Feb 2023 23:37:45 +0200 Subject: [PATCH 11/12] Make section more compact --- docs/distributions/debian/installation.md | 31 +++++------------------ 1 file changed, 7 insertions(+), 24 deletions(-) diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index 7887a3372..2482a381c 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -85,36 +85,19 @@ Steps: sudo apt update ``` -4. Now install the kernel upgrade script. +4. Install the kernel upgrade script: - * If your distro is Ubuntu-based, run: + * If your distro is **Ubuntu**-based, run `sudo apt install t2-kernel-script` + * If your distro is **Debian**-based, run `sudo apt install t2-kernel-script-debian` - ```bash - sudo apt install t2-kernel-script - ``` +5. Then upgrade your kernel to a T2 kernel by running `update_t2_kernel` - * If your distro is Debian-based, run: +6. Install the audio configuration files by running `sudo apt install apple-t2-audio-config` - ```bash - sudo apt install t2-kernel-script-debian - ``` - -5. Then upgrade your kernel to a T2 kernel by running: - - ```bash - update_t2_kernel - ``` - -6. Install the audio configuration files by running: - - ```bash - sudo apt install apple-t2-audio-config - ``` - - **Note:** If your distro is using PulseAudio by default, consider switching to PipeWire as mentioned in the [audio guide](https://wiki.t2linux.org/guides/audio-config/#audio-configuration-files). + **Note:** If your distro is using PulseAudio by default, consider switching to PipeWire for a better experience. For this, follow the [audio guide](https://wiki.t2linux.org/guides/audio-config/#audio-configuration-files). 7. Follow the [Wi-Fi guide](https://wiki.t2linux.org/guides/wifi-bluetooth/) to get internal Wi-Fi working. # Basic set up -After installing the new kernel, follow the [Basic setup](https://wiki.t2linux.org/guides/postinstall/) guide. You mainly have to follow the [Add necessary kernel parameters](https://wiki.t2linux.org/guides/postinstall/#add-necessary-kernel-paramaters) and [Make modules load on boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-boot) sections. If using disk encryption (LUKS), then follow the [Make modules load on early boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-early-boot) section as well. The rest has been set up automatically by the kernel upgrade script. +After installing the T2 kernel, follow the [Basic setup](https://wiki.t2linux.org/guides/postinstall/) guide. You mainly have to follow the [Add necessary kernel parameters](https://wiki.t2linux.org/guides/postinstall/#add-necessary-kernel-paramaters) and [Make modules load on boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-boot) sections. If using disk encryption (LUKS), then follow the [Make modules load on early boot](https://wiki.t2linux.org/guides/postinstall/#make-modules-load-on-early-boot) section as well. The rest has been set up automatically by the kernel upgrade script. From 0e74becc3ca50ee8915db80f044ae3c017510cb7 Mon Sep 17 00:00:00 2001 From: thefirethirteen Date: Tue, 7 Feb 2023 23:39:21 +0200 Subject: [PATCH 12/12] Fix typo --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 8fab4f54c..5c156216a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -85,7 +85,7 @@ nav: - Home: distributions/ubuntu/home.md - FAQ: distributions/ubuntu/faq.md - Installation: distributions/ubuntu/installation.md - - Debain, Linux Mint, Kali, Pop!_OS and other similar distros: + - Debian, Linux Mint, Kali, Pop!_OS and other similar distros: - Installation: distributions/debian/installation.md extra_css: