mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 10:21:53 +00:00
add separate guide for upgrade-kit
Signed-off-by: bitcoinmechanic <bitcoinmechanicCA@protonmail.com>
This commit is contained in:
@@ -10,7 +10,7 @@ Hardware Requirements
|
||||
---------------------
|
||||
|
||||
.. note::
|
||||
If you purchased the `upgrade kit <https://store.start9.com/collections/embassy/products/upgrade-kit>`_ from Start9, you can skip to :ref:`Instructions <migrate-02-instructions>`.
|
||||
If you purchased the `upgrade kit <https://store.start9.com/collections/embassy/products/upgrade-kit>`_ from Start9, you should follow :ref:`this guide<upgrade-kit>`.
|
||||
|
||||
#. `16GB microSD card <https://www.amazon.com/Sandisk-Ultra-Micro-UHS-I-Adapter/dp/B073K14CVB/>`_
|
||||
|
||||
@@ -40,9 +40,6 @@ With your Embassy safely backed up, it's time to proceed with the migration.
|
||||
Flashing
|
||||
........
|
||||
|
||||
.. note::
|
||||
If you purchased the `upgrade kit <https://store.start9.com/collections/embassy/products/upgrade-kit>`_ from Start9, you can skip to :ref:`Migrate <migrate-02-migrate>`.
|
||||
|
||||
#. Once you have all these you will need to download an 0.3.0 image from https://images.start9.com. This is free for all existing users. Anyone who is running 0.2.x who compiled it themselves will need to either compile 0.3.0 themselves or purchase an 0.3.0 image.
|
||||
|
||||
#. Once you have the image, flash it on to the 16GB SD card - the new one, **NOT** the one currently in your Embassy!
|
||||
@@ -73,7 +70,7 @@ Power Up
|
||||
|
||||
#. On your computer, open up a browser and go to http://embassy.local
|
||||
|
||||
#. You will be asked to enter a product key. This can be located on the bottom of your Embassy if you purchased, or in the repository folder if you built from source.
|
||||
#. You will be asked to enter your product key. This can be located on the bottom of your Embassy if you purchased, or in the repository folder if you built from source.
|
||||
|
||||
.. figure:: /_static/images/setup/migrate0.png
|
||||
:width: 60%
|
||||
|
||||
80
site/source/user-manual/upgrade-kit.rst
Normal file
80
site/source/user-manual/upgrade-kit.rst
Normal file
@@ -0,0 +1,80 @@
|
||||
.. _upgrade-kit:
|
||||
|
||||
========================================
|
||||
Upgrading from 0.2.x with an Upgrade Kit
|
||||
========================================
|
||||
|
||||
This guide will cover how to upgrade from EmbassyOS version 0.2.x to version 0.3.0.
|
||||
|
||||
.. note::
|
||||
If you purchased your own equipment please follow :ref:`this guide<upgrade-02>`.
|
||||
|
||||
.. _migrate-02-instructions:
|
||||
|
||||
Instructions
|
||||
------------
|
||||
|
||||
Backing up
|
||||
..........
|
||||
|
||||
.. caution:: It is prudent to back up your Embassy before migrating in case something doesn't work correctly, or there is an accident
|
||||
|
||||
If you're unsure how to do this - please follow `this <https://youtube.com/watch?v=_QJXgnE90ko>`_ guide.
|
||||
|
||||
.. youtube:: _QJXgnE90ko
|
||||
|
||||
With your Embassy safely backed up, it's time to proceed with the migration.
|
||||
|
||||
Migrating Data
|
||||
..............
|
||||
|
||||
#. Begin by going into your Embassy, stopping all running services, and shutting down the device in the Embassy tab.
|
||||
|
||||
#. Once you've heard the power-off sound, wait a few more seconds and then safely unplug the Embassy.
|
||||
|
||||
#. Next, remove the OLD SD card that is in your Embassy and place it into the SD card adaptor, and then connect the adaptor to any USB port on your Embassy.
|
||||
|
||||
#. Then take the NEW 16GB microSD card with 0.3.0 on it and place it into the microSD card slot on your Embassy. Be careful not to confuse the two microSD cards!
|
||||
|
||||
#. Next, plug the SSD into one of the USB 3.0 ports (the blue ones) on your Embassy, then reconnect the Ethernet cable if not already connected.
|
||||
|
||||
#. Now the power cable can be connected and the Embassy powered up.
|
||||
|
||||
Power Up
|
||||
........
|
||||
|
||||
#. Embassy will power up and then initialize, a process of less than 5 minutes. Once complete you will hear a _bep_ to indicate it is initialized and then a _chime_ sound to indicate it is online.
|
||||
|
||||
#. On your computer, open up a browser and go to http://embassy.local
|
||||
|
||||
#. You will be prompted that your drive and you SD card reader needed to be reconfigured and asked to unplug them and replug them into your Embassy. Please do this and hit refresh.
|
||||
|
||||
#. Next, you will be asked to select your old Embassy SD card - select rootfs
|
||||
|
||||
.. figure:: /_static/images/setup/migrate2.png
|
||||
:width: 60%
|
||||
|
||||
#. On the next page you will be asked to select a storage device - here you should select your SSD.
|
||||
|
||||
.. figure:: /_static/images/setup/migrate3.png
|
||||
:width: 60%
|
||||
|
||||
.. note:: If it does not show up, please power down Embassy, unplug it, plug it back in, and boot Embassy again
|
||||
|
||||
#. You will now need to make a password for your Embassy. It needs to be a strong password. This password protects your Embassy. It can be the same one that you used prior to migration, or a new one. Either way, make it strong, and make a backup of it. Without this you will **LOSE ALL ACCESS** to your Embassy!
|
||||
|
||||
#. Embassy will now recover all your data from your old Embassy and once finished, you will hear a _bep_, followed by a _chime_.
|
||||
|
||||
.. figure:: /_static/images/setup/migrate5.png
|
||||
:width: 60%
|
||||
|
||||
#. Now you will be provided with both a Tor and LAN address with which you can access your Embassy. A file download will contain this important information, which you should keep somewhere safe. It is also a good idea to make bookmarks on the devices that you will use to access your Embassy.
|
||||
|
||||
.. figure:: /_static/images/setup/migrate6.png
|
||||
:width: 60%
|
||||
|
||||
#. To use LAN safely, the SSL certificate will need to be added to whatever device you are using to access. This can be downloaded by clicking on "Download root CA" and installed by following the :ref:`instructions<connecting-lan>`.
|
||||
|
||||
#. You can now log in to your Embassy via Tor or LAN, and you will be given the option of recovering your data on a service-by-service basis.
|
||||
|
||||
.. note:: For those recovering Bitwarden - it is now called Vaultwarden.
|
||||
Reference in New Issue
Block a user