From cb1664099b90e87717966185102dc8820621d185 Mon Sep 17 00:00:00 2001
From: Daniel Micay <danielmicay@gmail.com>
Date: Mon, 5 Dec 2022 04:46:15 -0500
Subject: [PATCH] document GNOME bug causing installation issues

---
 static/install/cli.html | 8 ++++++++
 static/install/web.html | 8 ++++++++
 2 files changed, 16 insertions(+)

diff --git a/static/install/cli.html b/static/install/cli.html
index d16992aa..6cafc2f4 100644
--- a/static/install/cli.html
+++ b/static/install/cli.html
@@ -339,6 +339,14 @@ Installed as /home/username/platform-tools/fastboot</pre>
                 <p>Connect the phone to the computer. On Linux, you'll need to do this again if
                 you didn't have the udev rules set up when you connected it.</p>
 
+                <p>On Linux, GNOME has a bug causing compatibility issues with the installation
+                process. It wrongly detects the phone in fastboot mode or fastbootd mode as being
+                an MTP device and claims exclusive control over it. This will block the install
+                process from proceeding. We don't yet have more specific instructions on working
+                around this issue than avoiding GNOME or another desktop environment running the
+                GNOME services such as GVFS. We expect the problem is in GVFS, so stopping all of
+                the services should work, but you'll need to mask them or they'll auto restart.</p>
+
                 <p>On Windows, you need to install a driver for fastboot if you don't already have
                 it. No driver is needed on other operating systems. You can obtain the driver from
                 Windows Update which will detect it as an optional update when the device is
diff --git a/static/install/web.html b/static/install/web.html
index 5902684b..eccdbfa2 100644
--- a/static/install/web.html
+++ b/static/install/web.html
@@ -220,6 +220,14 @@
                 <p>Connect the phone to the computer. On Linux, you'll need to do this again if
                 you didn't have the udev rules set up when you connected it.</p>
 
+                <p>On Linux, GNOME has a bug causing compatibility issues with the installation
+                process. It wrongly detects the phone in fastboot mode or fastbootd mode as being
+                an MTP device and claims exclusive control over it. This will block the install
+                process from proceeding. We don't yet have more specific instructions on working
+                around this issue than avoiding GNOME or another desktop environment running the
+                GNOME services such as GVFS. We expect the problem is in GVFS, so stopping all of
+                the services should work, but you'll need to mask them or they'll auto restart.</p>
+
                 <p>On Windows, you need to install a driver for fastboot if you don't already have
                 it. No driver is needed on other operating systems. You can obtain the driver from
                 Windows Update which will detect it as an optional update when the device is