Start9/documentation
2
0
Fork 0
mirror of https://github.com/Start9Labs/documentation.git synced 2026-04-01 21:13:10 +00:00
Code Issues Packages Projects Releases Wiki Activity

copy changes

Browse Source
This commit is contained in:
Matt Hill
2022-12-09 10:11:50 -07:00
parent 372c29082d
commit 23845e8bf9
9 changed files with 43 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
site/source/user-manual/flashing/flashing-firmware.rst
View File

@@ -3,11 +3,11 @@
===================
Flashing (Firmware)
===================
This page is for existing Librem Mini owners ONLY. This will allow you to flash the custom firmware on your Librem to neutralize the Intel Management Engine (IME) and add embassyOS-specific tweaks to your system, such that it will operate just as an Embassy Pro bought from Start9 would. If you need hardware and want all the benefits listed here, you'll have to `buy an Embassy Pro <https://store.start9.com>`_.
This page is for existing Librem Mini owners ONLY. This will allow you to flash the custom firmware on your Librem to neutralize the Intel Management Engine (IME) and add embassyOS-specific tweaks to your system, such that it will operate just as an Embassy Pro bought from Start9 would. If you need hardware and want all the benefits listed here, you'll have to `buy an Embassy Pro <https://store.start9.com/products/embassy-pro>`_.
The source code can be viewed on Purism's `firmware git repo <https://source.puri.sm/firmware/pureboot/-/tree/start9-intel-wifi>`_.
.. note:: You will need a USB drive, formatted FAT32
.. note:: USB drive *must* be formatted for FAT32
#. Download the firmware (``pureboot-librem_mini_v2-basic_usb_autoboot.rom.gz``) from `Purism's git repository <https://source.puri.sm/firmware/releases/-/tree/master/librem_mini_v2/custom>`_ and extract it.

6
site/source/user-manual/flashing/flashing-arm.rst → site/source/user-manual/flashing/flashing-pi.rst
View File

@@ -1,9 +1,9 @@
.. _flashing-arm:
.. _flashing-pi:
==============
Flashing (ARM)
Flashing (Raspberry Pi)
==============
This guide is for flashing embassyOS to a micro SD card in order to install it to an ARM architecture device, namel the Raspberry Pi. Support for other ARM devices will come in future. For an up-to-date list of known-good hardware, please check out this `forum post <https://community.start9.com/t/known-good-hardware-master-list-hardware-capable-of-running-embassyos-v0-3-3/66/2>`_.
This guide is for flashing embassyOS to a micro SD card in order to install it on a Raspberry Pi.
.. note:: You will need a micro SD card of at least 16GB in size, 32GB recommended

2
site/source/user-manual/flashing/flashing-x86.rst
View File

@@ -3,7 +3,7 @@
==============
Flashing (x86)
==============
This guide is for flashing embassyOS to a USB drive in order to install it to an x86 architecture device. This will include most desktops, laptops, mini PCs, servers, and virtualization solutions. For an up-to-date list of known-good hardware, please check out this `forum post <https://community.start9.com/t/known-good-hardware-master-list-hardware-capable-of-running-embassyos-v0-3-3/66/2>`_.
This guide is for flashing embassyOS to a USB drive in order to install it to an x86 architecture device. This will include most desktops, laptops, mini PCs, servers, and virtual machines. For an up-to-date list of known-good hardware, please check out this `forum post <https://community.start9.com/t/known-good-hardware-master-list-hardware-capable-of-running-embassyos-v0-3-3/66/2>`_.
.. note:: You will need a USB drive of at least 16GB in size

12
site/source/user-manual/flashing/index.rst
View File

@@ -4,7 +4,7 @@
Flashing
========
Here you will find our flashing guides for ARM (Raspberry Pi) and x86 (most desktops, laptops, mini PCs, servers, etc) architectures. Librem Mini owners can use the firmware flashing guide to get embassyOS-specific firmware.
Here you will find our flashing guides for Raspberry Pi and x86 (most desktops, laptops, mini PCs, servers, etc) architectures. Librem Mini owners can use the firmware flashing guide to get embassyOS-specific firmware.
.. raw:: html
@@ -13,11 +13,11 @@ Here you will find our flashing guides for ARM (Raspberry Pi) and x86 (most desk
<div class="grid-x grid-margin-x">
.. topic-box::
:title: Flashing (ARM)
:link: flashing-arm
:title: Flashing (Raspberry Pi)
:link: flashing-pi
:icon: scylla-icon scylla-icon--apps
:class: large-4
:anchor: ARM Architecture
:anchor: View Guide
Flash embassyOS for use on a Raspberry Pi
@@ -26,7 +26,7 @@ Here you will find our flashing guides for ARM (Raspberry Pi) and x86 (most desk
:link: flashing-x86
:icon: scylla-icon scylla-icon--overview
:class: large-4
:anchor: x86 Architecture
:anchor: View Guide
Flash embassyOS for use on an x86 machine
@@ -43,7 +43,7 @@ Here you will find our flashing guides for ARM (Raspberry Pi) and x86 (most desk
:hidden:
:maxdepth: 2
flashing-arm
flashing-pi
flashing-x86
flashing-firmware

20
site/source/user-manual/reset-password.rst
View File

@@ -8,13 +8,12 @@ Reset Your Password
:depth: 2
:local:
#. Obtain the latest copy of embassyOS by `downloading it from Github <https://github.com/Start9Labs/embassy-os/releases/latest>`_. Under `Assets` near the bottom of the page, click to download eos.tar.gz (on Linux/MacOS) or eos.zip (on Windows).
#. Flash the downloaded image to your microSD card, using :ref:`this guide <flashing>`.
#. Insert the microSD card into your Embassy and power it on.
#. Download and flash the latest version of embassyOS, using the appropriate :ref:`flashing guide <flashing>` for your hardware.
#. Power on your Embassy, ensuring it is plugged in to Ethernet.
.. note:: Embassy will power up and then initialize. Once complete, you will hear a _bep_ to indicate it is initialized and then a _chime_ sound to indicate it is online.
.. note:: Embassy will power up and then initialize. If you have a speaker, you will hear first hear a _bep_ then a _chime_ sound to indicate the device is ready.
#. On your computer, open up a browser and go to http://embassy.local.
#. Using a phone or computer connected to the same network, open up a browser and go to http://embassy.local.
#. Select "Recover".
@@ -26,19 +25,12 @@ Reset Your Password
.. figure:: /_static/images/setup/screen1-restore_or_useexisting.jpg
:width: 60%
#. As instructed, plug in your embassyOS data drive and it will be detected.
#. Select your Embassy data drive
.. figure:: /_static/images/setup/screen4-select_storage.jpg
:width: 60%
.. note:: If your SSD does not show up, unplug it from the USB port and plug it back in a different (blue) USB 3.0 port
#. Wait a moment while it reads the data from your drive.
.. figure:: /_static/images/setup/screen6-storage_initialize.jpg
:width: 60%
#. Enter and confirm a new password of at least 12 characters when prompted. Save this password somewhere safe.
#. Enter and confirm a new password. This time, save it somewhere safe!
.. figure:: /_static/images/setup/screen5-set_password.jpg
:width: 60%