summaryrefslogtreecommitdiff
path: root/static/install.html
diff options
context:
space:
mode:
authorDaniel Micay <danielmicay@gmail.com>2021-01-03 21:55:44 -0500
committerDaniel Micay <danielmicay@gmail.com>2021-01-03 21:57:29 -0500
commited720c49a665a730f795023d9daf944a72cc13c3 (patch)
tree855dbddd7b6b157f27a264e3cadfc80725ba15b6 /static/install.html
parenta88a4d1563e437a6e0a83650489fb80993c5f486 (diff)
split out section on udev rules
Diffstat (limited to 'static/install.html')
-rw-r--r--static/install.html37
1 files changed, 27 insertions, 10 deletions
diff --git a/static/install.html b/static/install.html
index edcfe282..1c27b5c1 100644
--- a/static/install.html
+++ b/static/install.html
@@ -70,6 +70,7 @@
</ul>
</li>
<li><a href="#enabling-oem-unlocking">Enabling OEM unlocking</a></li>
+ <li><a href="#fastboot-as-non-root">Fastboot as non-root</a></li>
<li><a href="#connecting-phone">Connecting the phone</a></li>
<li><a href="#unlocking-the-bootloader">Unlocking the bootloader</a></li>
<li><a href="#obtaining-signify">Obtaining signify</a></li>
@@ -157,16 +158,12 @@
<ul>
<li>Arch Linux: <code>android-tools</code> provides fastboot and other useful
- tools not required for installation such as adb. <code>android-udev</code>
- provides udev rules allowing fastboot and adb to work in local sessions
- without root. Install both of these packages and skip the section
+ tools not required for installation such as adb. Skip the section
below on using the standalone platform-tools releases.</li>
- <li>Debian and Ubuntu: <code>android-sdk-platform-tools-common</code> provides
- udev rules allowing fastboot and adb to work in local sessions without root.
- The udev rules in Debian and Ubuntu are out-of-date, but it has the necessary
- entries for Pixel phones. The adb and fastboot packages are currently both
- broken and far too out-of-date to be any use, so avoid those. The version
- check in the flashing script will prevent accidentally using these.</li>
+ <li>Debian and Ubuntu: The adb and fastboot packages are currently both
+ broken and far too out-of-date to be any use, so avoid those. The
+ version check in the flashing script will prevent accidentally using
+ these.</li>
</ul>
<section id="standalone-platform-tools">
@@ -239,10 +236,30 @@ Installed as /home/username/platform-tools/fastboot</pre>
Play services as part of Factory Reset Protection (FRP) for anti-theft protection.</p>
</section>
+ <section id="fastboot-as-non-root">
+ <h2><a href="#fastboot-as-non-root">Fastboot as non-root</a></h2>
+
+ <p>On Linux, in order to run the <code>fastboot</code> command as non-root you'll
+ need udev rules to properly set up the USB device.</p>
+
+ <p>On Arch Linux:</p>
+
+ <pre>sudo pacman -S android-udev</pre>
+
+ <p>On Debian and Ubuntu:</p>
+
+ <pre>sudo apt install android-sdk-platform-tools-common</pre>
+
+ <p>The udev rules on Debian and Ubuntu are very out-of-date but the package has
+ the rules needed for Pixel phones since the same USB IDs have been used for many
+ years.</p>
+ </section>
+
<section id="connecting-phone">
<h2><a href="#connecting-phone">Connecting the phone</a></h2>
- <p>Connect the phone to the computer if you haven't already.</p>
+ <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>
</section>
<section id="unlocking-the-bootloader">