Clarify / fix instructions (#413)

* Clarify / fix instructions

* touchup for consistency
This commit is contained in:
gStart9
2023-06-26 14:59:15 +00:00
committed by GitHub
parent 3780e8ad76
commit 867a582082
2 changed files with 13 additions and 20 deletions

View File

@@ -5,10 +5,10 @@ Flashing (Raspberry Pi)
=======================
This guide is for flashing StartOS to a micro SD card in order to install it on a Raspberry Pi with an external SSD. Please contact support if you need to re-install your OS on a Lite (SD card storage).
.. warning:: DO NOT DO THIS UNLESS YOU HAVE AN EXTERNAL SSD. If you are running in a "Lite" configuration (everything on an SD card), then flashing in this manner WILL ERASE ALL YOUR DATA! Contact support for assistance.
.. warning:: DO NOT DO THIS UNLESS YOU HAVE AN EXTERNAL SSD. If you are running in a "Lite" configuration (everything on an SD card), then flashing in the manner proscribed below WILL ERASE ALL YOUR DATA! Contact support for assistance instead.
Getting and Extracting the Image
--------------------------------
Getting StartOS
---------------
Visit the `Github release page <https://github.com/Start9Labs/start-os/releases/latest>`_ to find the latest StartOS release.
At the bottom of the page, under "Assets," download the ``startos-..._raspberrypi.img.gz`` file.

View File

@@ -11,46 +11,39 @@ Getting StartOS
---------------
Visit the `Github release page <https://github.com/Start9Labs/start-os/releases/latest>`_ to find the latest StartOS release.
At the bottom of the page, under "Assets," download the ``x86_64.iso`` or ``x86_64-nonfree.iso`` file. The former image contains no proprietary software (built for the Server Pure). As the title implies, the latter, ``nonfree`` image, contains non-free software. This may be required for your hardware, especially for Kiosk mode or WiFi.
At the bottom of the page, under "Assets," download the ``x86_64.iso`` or ``x86_64-nonfree.iso`` file. The former image contains no proprietary software (built for the Server Pure). As the title implies, the latter, ``nonfree`` image, contains non-free (closed-source) software. This may be required for your hardware, especially for graphics and/or wireless device support.
.. figure:: /_static/images/flashing/x86_64-asset.png
:width: 60%
(OPTIONAL) Select your OS to verify the image (be sure to use the correct file name):
Select your OS to continue:
.. tabs::
.. group-tab:: Linux
Verify the checksum against the one listed on GitHub by opening a terminal in the folder you downloaded the image to and running:
(SHA256):
(Optional, but recommended) Verify the checksum against the one listed on GitHub (SHA256):
.. code-block::
sha256sum startos-0.3.4.2-bbd66e9-20230519_x86_64.iso
or (BLAKE3):
.. code-block::
b3sum startos-0.3.4.2-bbd66e9-20230519_x86_64.iso
sha256sum startos-0.3.4.2-efc56c0-20230525_x86_64.iso
.. group-tab:: Mac
Verify the checksum against the one listed on GitHub by opening a terminal in the folder you downloaded the image to and running:
(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_x86_64.iso
openssl dgst -sha256 startos-0.3.4.2-efc56c0-20230525_x86_64.iso
.. group-tab:: Windows
Verify the checksum against the one listed on GitHub by opening a ``cmd`` prompt "As Administrator" in the folder you saved the image to and 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_x86_64.iso
cd Downloads
Get-FileHash startos-0.3.4.2-efc56c0-20230525_x86_64.iso
Installing StartOS
------------------