Mac LAN fix, DIY and Flashing guide refactors

2026-03-30 04:01:59 +00:00 · 2022-12-08 16:39:13 -07:00
parent a869c9825a
commit ad3b15e065
17 changed files with 356 additions and 250 deletions
--- a/site/source/diy/diy-arm.rst
+++ b/site/source/diy/diy-arm.rst
@@ -0,0 +1,74 @@
+.. _diy-arm:
+
+===============
+DIY Guide (ARM)
+===============
+
+.. contents::
+    :depth: 2 
+    :local:
+
+Start9 is committed to ensuring that embassyOS is accessible.  It will always be possible to build a comprable device to those sold by Start9.  You can use the following guide to build your own Embassy One, the Raspberry Pi-based device available from the `Start9 Store <store.start9.com>`_.  If any links are broken or sold out, or if you need help or want to share your experience, please `head to our forums <https://community.start9.com/>`_.  Want to support Sovereign Computing?  Please consider a `donation to Start9 <https://btcpay.start9.com/apps/2Et1JUmJnDwzKncfVBXvspeXiFsa/crowdfund>`_.
+
+    .. figure:: /_static/images/diy/pi.png
+        :width: 40%
+        :alt: Raspberry Pi
+
+Hardware
+--------
+The first thing you'll need to do is gather the hardware and assemble it.  Below is the "official" hardware spec.  For an alternate build option, see this `Geekworm NAS Case guide <https://community.start9.com/t/diy-embassy-using-geekworm-nas-case-w-optional-ups>`_.
+
+Parts
+=====
+    #. `Geekworm NASPi v2.0 <https://geekworm.com/products/geekworm-naspi-2-5-sata-hdd-ssd-kit-for-raspberry-pi-4-model-b?_pos=2&_sid=06be31b61&_ss=r&variant=39426059731032>`_ ~$60 USD
+
+        - It is important to get the 2.0 version as it has the ability to power back on automatically following a power outage.
+        - MAKE SURE YOU GET THE CORRECT POWER SUPPLY FOR YOUR REGION
+
+    #. `Raspberry Pi 4 (8GB RAM model) <https://www.amazon.com/LANDZO-Raspberry-Pi-Model-8gb/dp/B08R87H4RR/>`_ ~$75-200 USD
+
+        - These have more than doubled in price in 2022. You may want to shop around, or buy used if need be.
+
+    #. `Internal SSD (1TB minimum) <https://www.amazon.com/Crucial-MX500-NAND-SATA-Internal/dp/B078211KBB>`_ ~$80 USD+
+
+        - 1TB minimum is recommended, however this all depends on your use-case.
+        - 1TB is plenty for a full Bitcoin/Lightning stack OR a good amount of file storage, but not both if you want your device to be useful for years to come. 2TB or more is recommended if it is in your budget.  You can always upgrade this later, and storage keeps getting cheaper.
+
+    #. `SD Card (32GB) <https://www.amazon.com/dp/B07P14QHB7>`_ ~$10 USD
+
+        - A larger size is not necessary as it adds no benefit.
+
+    #. `Ethernet Cable (Cat5 or Cat6) <https://www.amazon.com/Monoprice-Flexboot-Ethernet-Patch-Cable/dp/B00AJHBZLM/>`_ ~$2 USD
+
+        - You may have one laying around. Keep in mind the length you will require, e.g., how far away will your Embassy be from your router? 3-6ft is normally plenty.
+
+    #. `Speaker <https://www.amazon.com/Corporate-Computer-Motherboard-Internal-Speaker/dp/B01527H4W2/>`_ ~$5 USD
+
+        - Not strictly required, but HIGHLY recommended.
+
+    #. `2-Pin Male-to-Male Power Wire <https://geekworm.com/products/usb3-0-connector?variant=33744636674136>`_ ~$5 USD
+
+        - Required if using a speaker or Noctua fan.
+
+    #. (Optional) `Noctua NF-A4x10 5v Fan (Get all below) <https://www.amazon.com/Noctua-Cooling-Bearing-NF-A4X10-FLX-5V/dp/B00NEMGCIA/>`_ ~$15 USD
+
+        - Recommended over the less-than-great Geekworm factory fan.
+        - None of the included screws are long enough, so you will need 2 screws (M3-.50x12), available online or at any hardware store for <$1 USD.
+        - 2x Male-to-Female jumper wires - unfortunately these only come in high quantities, so you may want to organize a group buy. ~$9
+
+    #. (Optional) MicroSD to USB adapter
+
+        - For flashing the OS. Not necessary if you have a way to mount an SD card already, such as an SD card slot on a laptop.
+
+    .. note:: Estimated total cost: ~$375-460+ with 1-2TB of storage
+
+Assembly
+========
+You can follow along with this `written guide <https://community.start9.com/t/diy-embassy-one-geekworm-naspi-case>`_ and/or our assembly video below:
+
+    .. youtube:: Z1EW1TVgtow
+        :width: 100%
+
+Flash and Install embassyOS
+---------------------------
+After building your hardware build, you will need a copy of embassyOS.  Head over to our :ref:`Flashing (ARM) Guide <flashing-arm>` to complete your Embassy One build.
--- a/site/source/diy/diy-x86.rst
+++ b/site/source/diy/diy-x86.rst
@@ -0,0 +1,36 @@
+.. _diy-x86:
+
+===============
+DIY Guide (x86)
+===============
+
+.. contents::
+    :depth: 2 
+    :local:
+
+Start9 is committed to ensuring that embassyOS is accessible.  It will always be possible to build a comprable device to those sold in the `Start9 Store <https://store.start9.com>`_.  You can use the following guide to build your own Embassy with readily available hardware.  If you need help or want to share your experience, please `head to our forums <https://community.start9.com/>`_.  Want to support Sovereign Computing?  Please consider a `donation to Start9 <https://btcpay.start9.com/apps/2Et1JUmJnDwzKncfVBXvspeXiFsa/crowdfund>`_.
+
+
+Hardware
+--------
+With x86 support, embassyOS can now be run on a very wide array of hardware.  You can even try out or run eOS in a Virtual Machine (VM) without having to buy any hardware whatsoever!  Check out `this forum post <https://community.start9.com/t/known-good-hardware-master-list-hardware-capable-of-running-embassyos-v0-3-3/>`_ for the most up-to-date list of known-good hardware.
+
+.. _os-reqs:
+
+.. note:: embassyOS is based on Linux, and on its own, is fairly lightweight.  The hardware you require will depend mostly on how you intend to use your Embassy.  If you intend to use a Bitcoin stack, you will want at least 8GB of RAM and 1TB of storage.  If you mostly intend to use your server to store and manage files/passwords, then RAM will be less important and storage will depend on your needs.  Check the current size of your existing storage solution (such as Dropbox or iCloud) to get an idea what you will require.
+
+Minimum OS Requirements
+.......................
+- Single vCPU Core 2Ghz
+- 4GB RAM
+- 64GB Storage
+
+Recommended OS Requirements
+...........................
+- Quad-Core CPU 2.5Ghz+
+- 8GB+ RAM
+- 1TB+ Storage
+
+Flash and Install embassyOS
+---------------------------
+After building your hardware build, you will need a copy of embassyOS.  Head over to our :ref:`Flashing (x86) Guide <flashing-x86>` to complete your Embassy build.
--- a/site/source/diy/index.rst
+++ b/site/source/diy/index.rst
@@ -0,0 +1,49 @@
+.. _diy:
+
+===
+DIY
+===
+Here you will find guides for building your own Embassy!  Currently, embassyOS is supported on the Raspberry Pi (ARM architecture), and on most desktops, laptops, mini PCs, servers, and virtualization solutions (x86).
+
+Motivation
+----------
+There are several reasons you might prefer to build your own Embassy instead of purchasing one from us:
+
+    #. You already own the necessary hardware and would like to re-purpose it.
+    #. You want to save on shipping or import costs to your location.
+    #. You do not trust Start9's supply chain.
+    #. You do not want to share your shipping address.
+    #. You like building things.
+
+.. raw:: html
+
+  <div class="topics-grid grid-container full">
+
+  <div class="grid-x grid-margin-x">
+
+.. topic-box::
+  :title: DIY (ARM)
+  :link: diy-arm
+  :icon: scylla-icon scylla-icon--apps
+  :class: large-4
+  :anchor: ARM Architecture
+
+  Build an Embassy using a Raspberry Pi
+
+.. topic-box::
+  :title: DIY (x86)
+  :link: diy-x86
+  :icon: scylla-icon scylla-icon--overview
+  :class: large-4
+  :anchor: x86 Architecture
+
+  Build an Embassy on an x86 machine
+
+.. toctree::
+  :hidden:
+  :maxdepth: 1
+
+  diy-arm
+  diy-x86
+
+Appreciate what we're doing?  Please consider a `donation to Start9 <https://btcpay.start9.com/apps/2Et1JUmJnDwzKncfVBXvspeXiFsa/crowdfund>`_.