mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-30 04:01:59 +00:00
60f83aa683
* change embassyOS to StartOS & nuance * Update conf.py * Update manifest.rst * say start9 instead of embassy in two links * progress * scrubbed faqs - basic-use, lightning, service-packaging, services, startos * add a few fixes * more * more 'embassy' cleanup * more * the last of embassy (aside from sdk and cli commands, links, etc) * some fixes * update icon, logo, and theme * Update site/source/user-manual/upgrade-hardware/upgrade-pro.rst * Update site/source/developer-docs/packaging.rst * Update site/source/developer-docs/specification/config-spec.rst * Update site/source/learn/concepts/networks.rst * Update site/source/learn/concepts/networks.rst * Update site/source/user-manual/customize.rst * Update site/source/support/faq/faq-basic-use.rst * Update site/source/user-manual/upgrade-hardware/naspi-upgrade.rst * Update site/source/user-manual/upgrade-hardware/upgrade-pro.rst * Update site/source/support/faq/faq-bitcoin.rst * Update site/source/support/faq/faq-bitcoin.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-services.rst * Update site/source/support/faq/faq-general.rst * Update site/source/support/faq/faq-startos.rst * Update site/source/support/faq/faq-troubleshooting.rst * Update site/source/support/faq/faq-startos.rst * Minor fixes * Fix build errors, ready to roll * Add Beethoven * More fixes * More nother fix * More nother fixes agin * Remove sentence * cards instead --------- Co-authored-by: Matt Hill <matthewonthemoon@gmail.com> Co-authored-by: Shadowy Super Coder <musashidisciple@proton.me> Co-authored-by: Lucy Cifferello <12953208+elvece@users.noreply.github.com> Co-authored-by: kn0wmad <39687477+kn0wmad@users.noreply.github.com> Co-authored-by: agent <kn0wmad@protonmail.com>
91 lines
3.2 KiB
ReStructuredText
91 lines
3.2 KiB
ReStructuredText
.. _flashing-pi:
|
|
|
|
=======================
|
|
Flashing (Raspberry Pi)
|
|
=======================
|
|
This guide is for flashing StartOS to a micro SD card in order to install it on a Raspberry Pi.
|
|
|
|
Getting and Extracting the Image
|
|
--------------------------------
|
|
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 ``raspberrypi.img.gz`` file.
|
|
|
|
.. figure:: /_static/images/flashing/raspi-asset.png
|
|
:width: 60%
|
|
:alt: Raspberry Pi Asset
|
|
|
|
Select your OS to continue:
|
|
|
|
.. tabs::
|
|
|
|
.. group-tab:: Linux
|
|
|
|
#. Open a terminal in the folder you downloaded to and extract with:
|
|
|
|
.. 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
|
|
|
|
.. 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:
|
|
|
|
.. code-block::
|
|
|
|
openssl dgst -sha256 startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img
|
|
|
|
.. 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:
|
|
|
|
.. code-block::
|
|
|
|
Get-FileHash startos-0.3.4.2-bbd66e9-20230519_raspberrypi.img
|
|
|
|
Installing StartOS
|
|
------------------
|
|
Once you have extracted the StartOS ``.img`` file, you will need to flash it onto a microSD card.
|
|
|
|
#. Download `balenaEtcher <https://www.balena.io/etcher/>`_ onto your Linux, Mac, or Windows computer.
|
|
|
|
#. Insert the microSD card into your computer, either directly or using an adapter.
|
|
|
|
#. Open balenaEtcher.
|
|
|
|
.. figure:: /_static/images/diy/balena.png
|
|
:width: 60%
|
|
:alt: Balena Etcher Dashboard
|
|
|
|
#. Click "Select Image" and select the ``.img`` file.
|
|
|
|
#. Click "Select Target" and select your microSD card.
|
|
|
|
.. warning:: BE ABSOLUTELY CERTAIN you have selected the correct target microSD card. Whatever drive you select will be **COMPLETELY ERASED**!!
|
|
|
|
#. Click "Flash!". You may be asked to approve the unusually large disk target and/or enter your password. Both are normal.
|
|
|
|
#. After the flash completes, you may remove the newly flashed micro SD card from any adapter, and insert it into your server's SD card slot.
|
|
|
|
#. Finally, continue to the :ref:`Initial Setup <initial-setup>`, :ref:`Manual Update <manual-update>`, or :ref:`Reset Password <reset-password>` instructions - depending on your need.
|