From 297725ae4e004cf6e1a5ace2dde848f3df61af4f Mon Sep 17 00:00:00 2001 From: gStart9 <106188942+gStart9@users.noreply.github.com> Date: Wed, 7 Jun 2023 05:35:02 +0000 Subject: [PATCH] Extraction and Verification touchups (#397) --- .../user-manual/flashing/flashing-pi.rst | 43 ++++++------------- 1 file changed, 12 insertions(+), 31 deletions(-) diff --git a/site/source/user-manual/flashing/flashing-pi.rst b/site/source/user-manual/flashing/flashing-pi.rst index 8a23188..ff03fc1 100644 --- a/site/source/user-manual/flashing/flashing-pi.rst +++ b/site/source/user-manual/flashing/flashing-pi.rst @@ -9,7 +9,7 @@ Getting and Extracting the Image -------------------------------- Visit the `Github release page `_ to find the latest StartOS release. -At the bottom of the page, under "Assets," download the ``raspberrypi.img.gz`` file. +At the bottom of the page, under "Assets," download the ``startos-..._raspberrypi.img.gz`` file. .. figure:: /_static/images/flashing/raspi-asset.png :width: 60% @@ -21,53 +21,34 @@ Select your OS to continue: .. group-tab:: Linux - #. Open a terminal in the folder you downloaded to and extract with: + (Optional, but recommended) Verify the checksum against the one listed on GitHub (SHA256): .. code-block:: - tar -xzvf startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img.gz - - #. (Optional, but recommended) Verify the checksum against the one listed on GitHub (SHA256): - - .. code-block:: - - sha256sum startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img - - or (BLAKE3): - - .. code-block:: - - b3sum startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img + sha256sum startos-0.3.4.2-efc56c0-20230525_raspberrypi.img.gz .. group-tab:: Mac - #. Right-click ``startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img.gz``, click "Open with," then click Archive Utility to extract. - - #. (Optional, but recommended) Verify the checksum against the one listed on GitHub by opening a terminal and entering: + (Optional, but recommended) Verify the checksum against the one listed on GitHub by opening a terminal and entering: .. code-block:: - openssl dgst -sha256 startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img + openssl dgst -sha256 startos-0.3.4.2-efc56c0-20230525_raspberrypi.img.gz .. group-tab:: Windows - - #. Open a ``cmd`` prompt "As Administrator" in the folder you saved the image to and use the following command to extract it: - - .. code-block:: - - tar -xzvf startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img.gz - - #. (Optional, but recommended) Verify the checksum against the one listed on GitHub by running: + + (Optional, but recommended) Verify the checksum against the one listed on GitHub by opening Windows PowerShell, changing your directory to where you downloaded the .img.gz file, and running `Get-FileHash`: .. code-block:: - Get-FileHash startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img + cd Downloads + Get-FileHash startos-0.3.4.2-efc56c0-20230525_raspberrypi.img.gz Installing StartOS ------------------ -Once you have extracted the StartOS ``.img`` file, you will need to flash it onto a microSD card. +Once you have the StartOS ``.img.gz`` file, you will need to flash it onto a microSD card. -#. Download `balenaEtcher `_ onto your Linux, Mac, or Windows computer. +#. Download and install `balenaEtcher `_ onto your Linux, Mac, or Windows computer. #. Insert the microSD card into your computer, either directly or using an adapter. @@ -77,7 +58,7 @@ Once you have extracted the StartOS ``.img`` file, you will need to flash it ont :width: 60% :alt: Balena Etcher Dashboard -#. Click "Select Image" and select the ``.img`` file. +#. Click "Select Image" and select the ``.img.gz`` file. #. Click "Select Target" and select your microSD card.