From d1709ac7b9becf4fe9cdd7d58cecb39cfabe1b97 Mon Sep 17 00:00:00 2001
From: Daniel Micay <danielmicay@gmail.com>
Date: Fri, 1 May 2020 18:34:35 -0400
Subject: [PATCH] split out TMPDIR troubleshooting information

---
 static/install.html | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/static/install.html b/static/install.html
index ac8f3ca1..825f9360 100644
--- a/static/install.html
+++ b/static/install.html
@@ -247,20 +247,12 @@ curl -O https://releases.grapheneos.org/crosshatch-factory-2020.04.14.23.zip.sig
 
             <p>Reboot into the bootloader interface to begin the flashing procedure.</p>
 
-            <p>Next, extract the factory images and run the script to flash them. Note that the
-            <code>fastboot</code> command run by the flashing script requires a fair bit of free
-            space in a temporary directory, which defaults to <code>/tmp</code>:</p>
+            <p>Next, extract the factory images and run the script to flash them.:</p>
 
             <pre>unzip crosshatch-factory-2020.04.14.23.zip
 cd crosshatch-qq2a.200405.005
 ./flash-all.sh</pre>
 
-            <p>Use a different temporary directory if your <code>/tmp</code> doesn't have enough
-            space available:</p>
-
-            <pre>mkdir tmp
-TMPDIR="$PWD/tmp" ./flash-all.sh</pre>
-
             <p>Wait for the flashing process to complete and for the device to boot up using the
             new operating system.</p>
 
@@ -276,6 +268,16 @@ TMPDIR="$PWD/tmp" ./flash-all.sh</pre>
                 <a href="#troubleshooting">Troubleshooting</a>
             </h3>
 
+            <p>A common issue on Linux distributions is that they mount the default temporary file
+            directory <code>/tmp</code> as tmpfs which results in it being backed by memory and
+            swap rather than persistent storage. By default, the size is 50% of the available
+            virtual memory. This is often not enough for the flashing process, especially since
+            <code>/tmp</code> is shared between applications and users. To use a different
+            temporary directory if your <code>/tmp</code> doesn't have enough space available:</p>
+
+            <pre>mkdir tmp
+TMPDIR="$PWD/tmp" ./flash-all.sh</pre>
+
             <p>A majority of failed flashes tend to be caused by substandard USB connectors,
             plugging in via hubs or bad cables which aren't properly up to the USB standard. The
             scrollback from a failed flash will contain valuable diagnostic information which