diff options
| -rw-r--r-- | static/install.html | 20 |
1 files 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 |