From 399d28714f3a370f015641ff9e0a6da811f31f9e Mon Sep 17 00:00:00 2001
From: Daniel Micay <daniel.micay@grapheneos.org>
Date: Sat, 25 Nov 2023 20:28:54 -0500
Subject: document workaround for fwupd bug

---
 static/install/cli.html | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'static/install/cli.html')

diff --git a/static/install/cli.html b/static/install/cli.html
index b1f48a0a..602ae82d 100644
--- a/static/install/cli.html
+++ b/static/install/cli.html
@@ -70,6 +70,7 @@
                     </li>
                     <li><a href="#checking-fastboot-version">Checking fastboot version</a></li>
                     <li><a href="#flashing-as-non-root">Flashing as non-root</a></li>
+                    <li><a href="#working-around-fwupd-bug-on-linux-distributions">Working around fwupd bug on Linux distributions</a></li>
                     <li><a href="#booting-into-the-bootloader-interface">Booting into the bootloader interface</a></li>
                     <li><a href="#connecting-device">Connecting the device</a></li>
                     <li><a href="#unlocking-the-bootloader">Unlocking the bootloader</a></li>
@@ -299,6 +300,18 @@ Installed as /home/username/platform-tools/fastboot</pre>
                 years.</p>
             </section>
 
+            <section id="working-around-fwupd-bug-on-linux-distributions">
+                <h2><a href="#working-around-fwupd-bug-on-linux-distributions">Working around fwupd bug on Linux distributions</a></h2>
+
+                <p>The fwupd software used by many traditional Linux distributions (not Android or
+                ChromeOS) has a bug breaking connecting to fastboot devices. The web installer
+                takes slightly longer to connect to the device and is more impacted by this. If
+                you're on a Linux distribution with fwupd running, stop it before proceeding. You
+                can do this by running the following command in a terminal:</p>
+
+                <pre>sudo systemctl stop fwupd.service</pre>
+            </section>
+
             <section id="booting-into-the-bootloader-interface">
                 <h2><a href="#booting-into-the-bootloader-interface">Booting into the bootloader interface</a></h2>
 
-- 
cgit v1.3.1