document workaround for fwupd bug

static/install/cli.html

@@ -70,6 +70,7 @@ <h2><a href="#table-of-contents">Table of contents</a></h2>
                     </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,19 @@ <h2><a href="#flashing-as-non-root">Flashing as non-root</a></h2>
                 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 href="https://github.com/fwupd/fwupd/issues/6437">a bug breaking
+                connecting to fastboot devices</a>. 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 uit 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>
 

static/install/web.html

@@ -54,6 +54,7 @@ <h2><a href="#table-of-contents">Table of contents</a></h2>
                     <li><a href="#prerequisites">Prerequisites</a></li>
                     <li><a href="#enabling-oem-unlocking">Enabling OEM unlocking</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>
@@ -188,6 +189,19 @@ <h2><a href="#flashing-as-non-root">Flashing as non-root</a></h2>
                 Ubuntu, install the <code>android-sdk-platform-tools-common</code> package.</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 href="https://github.com/fwupd/fwupd/issues/6437">a bug breaking
+                connecting to fastboot devices</a>. 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 uit 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>