mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 02:11:55 +00:00
fix promo banner, delete old folders
This commit is contained in:
@@ -96,11 +96,10 @@ html_theme_options = {
|
||||
"conf_py_path": "docs/source/",
|
||||
"banner_button_text": "Learn more",
|
||||
"banner_button_url": "https://docs.start9.com/latest",
|
||||
"banner_icon_path": "_static/logo.png",
|
||||
"banner_title_text": "Start9 0.3.0 is now released 🥳",
|
||||
"banner_title_text": "EmbassyOS 0.3.0 is now released 🥳",
|
||||
"hide_edit_this_page_button": "false",
|
||||
"hide_sidebar_index": "true",
|
||||
"hide_banner": "true",
|
||||
"hide_banner": "false",
|
||||
"hide_version_dropdown": [],
|
||||
"github_issues_repository": "Start9Labs/documentation",
|
||||
"github_repository": "Start9Labs/documentation",
|
||||
|
||||
@@ -1,17 +0,0 @@
|
||||
Contributing
|
||||
============
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:hidden:
|
||||
|
||||
embassyos
|
||||
services/index
|
||||
|
||||
.. panel-box::
|
||||
:title: Overview
|
||||
:id: contributing
|
||||
:class: my-panel
|
||||
|
||||
* :doc:`Developer Contributions <embassyos>` - Learn how you can contribute to EmbassyOS
|
||||
* :doc:`Service Packaging Guide <services/index>` - Learn more about packaging services for EmbassyOS
|
||||
@@ -1,92 +0,0 @@
|
||||
.. _diy:
|
||||
|
||||
*********
|
||||
DIY Guide
|
||||
*********
|
||||
|
||||
.. figure:: /_static/images/diy/pi.png
|
||||
:width: 40%
|
||||
:alt: Raspberry Pi
|
||||
|
||||
Raspberry Pi Board
|
||||
|
||||
By popular demand, we are pleased to present this "Do it Yourself" (DIY) guide for the Start9 Embassy personal server!
|
||||
|
||||
.. warning:: This DIY guide has directions for EmbassyOS version 0.2.x. When 0.3.0 launches it will REQUIRE hardware updates, which you can find `here <https://start9.com/eos-0.3.0>`__. Please keep in mind that version 0.3.x is not yet available for purchase or DIY!! Please stay tuned to our community channels for updates.
|
||||
|
||||
Motivation
|
||||
==========
|
||||
|
||||
There are four 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 live outside the US and want to save on shipping costs.
|
||||
|
||||
#. You do not trust Start9's supply chain.
|
||||
|
||||
#. You do not want to share your shipping address.
|
||||
|
||||
#. You just like building things.
|
||||
|
||||
Building an Embassy
|
||||
===================
|
||||
|
||||
.. Hardware: Components
|
||||
.. --------------------
|
||||
|
||||
.. #. `Raspberry Pi 4B (8GB) <https://raspberrypi.org/products/raspberry-pi-4-model-b/?variant=raspberry-pi-4-model-b-8gb>`_
|
||||
.. #. `Power supply for Raspberry Pi 4B <https://raspberrypi.org/products/type-c-power-supply/>`_ Make sure this is at minimum 15w and 3.5a.
|
||||
.. #. Case for Raspberry Pi 4B (`passive cooling recommended <https://www.amazon.com/Geekworm-Raspberry-Aluminum-Passive-Heatsink/dp/B07Z6FYHCH/>`_ `*`)
|
||||
.. #. A `16GB microSD card <https://amazon.com/SanDisk-Endurance-microSDXC-Adapter-Monitoring/dp/B07NY23WBG/>`_ (no need for bigger). If you have ABSOLUTELY NO data to migrate, you may choose to re-use the card already in your Embassy.
|
||||
.. #. `GPIO mini speaker/buzzer <https://www.amazon.com/Corporate-Computer-Motherboard-Internal-Speaker/dp/B01527H4W2/>`_ (These often sell out, please let us know if this link needs to be refreshed)
|
||||
.. #. Ethernet cable
|
||||
.. #. MicroSD → USB adapter (or you may have a microSD port on your computer)
|
||||
.. #. An external drive (1TB minimum, 2TB SSD recommended), or an `internal drive <https://www.amazon.com/Crucial-MX500-NAND-SATA-Internal/dp/B078211KBB>`_ with an `USB enclosure <https://www.amazon.com/gp/product/B07T9D8F6C>`_, as sold with our upgrade kits. MUST CONNECT OVER USB 3.0
|
||||
|
||||
.. `*` If you use a fan, **DO NOT** use the official Raspberry Pi fan, as it requires the same GPIO pins as the audio speaker. Instead, we recommend `this fan <https://www.amazon.com/Raspberry-iUniker-30x30x7mm-Brushless-RetroFlag/dp/B076H3TKBP/>`_.
|
||||
|
||||
.. Hardware: Assembly Instructions
|
||||
.. -------------------------------
|
||||
|
||||
.. #. Insert mini speaker/buzzer into GPIO pins 6/8/10/12 with the word "speaker" facing out, `away from the board`.
|
||||
|
||||
.. .. figure:: /_static/images/diy/pins.png
|
||||
.. :width: 60%
|
||||
.. :alt: Speaker board spec
|
||||
|
||||
.. #. Place the Raspberry Pi 4 board (with speaker attached), into its case.
|
||||
.. #. Plug in the external drive to one of the USB 3.0 (blue) slots
|
||||
|
||||
.. Getting EmbassyOS: Purchasing
|
||||
.. -----------------------------
|
||||
|
||||
.. You can purchase EmbassyOS `here <https://store.start9.com/collections/embassy/products/embassyos-software-download>`_. This is by far the easiest path to get up and running.
|
||||
|
||||
.. Depending on your Internet speed, the download should take between 5 and 30 minutes.
|
||||
|
||||
.. Getting EmbassyOS: Building from Source
|
||||
.. ---------------------------------------
|
||||
|
||||
.. A detailed build guide will be available around the time of the v0.3.0 release (or now, if you snoop around our GitHub long enough).
|
||||
|
||||
.. Installing EmbassyOS
|
||||
.. --------------------
|
||||
|
||||
.. Whether you purchase EmbassyOS from us or build it yourself, you need to flash it onto a microSD card.
|
||||
|
||||
.. #. Download `balenaEtcher <https://www.balena.io/etcher/>`_ onto your Mac, Windows, or Linux computer.
|
||||
.. #. Insert the microSD card into your computer, either directly or using an adapter.
|
||||
.. #. Open balenaEtcher.
|
||||
.. #. Click `Select Image`, then find and select your copy of EmbassyOS.
|
||||
.. #. Click `Select Target`, then find and select your micro SD card.
|
||||
.. #. Click `Flash!` You may be asked to (1) approve the unusually large disk target or (2) enter your password. Both are normal.
|
||||
|
||||
.. .. figure:: /_static/images/diy/balena.png
|
||||
.. :width: 60%
|
||||
.. :alt: Balena Etcher Dashboard
|
||||
|
||||
.. #. Once the image is flashed and verified, you may remove the micro SD, insert it into your Embassy, and power up the device.
|
||||
.. #. The Embassy is now ready for use, and you may following the normal :ref:`setup <initial-setup>` instructions. ``*``
|
||||
|
||||
.. ``*`` The first time you power it on, your Embassy will make more noises than future attempts, and it may take several minutes to finally complete.
|
||||
@@ -1,19 +0,0 @@
|
||||
Getting Started
|
||||
===============
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:hidden:
|
||||
|
||||
introduction
|
||||
purchasing
|
||||
diy
|
||||
|
||||
.. panel-box::
|
||||
:title: Overview
|
||||
:id: "getting-started"
|
||||
:class: my-panel
|
||||
|
||||
* :doc:`Introduction <introduction>` - Welcome to the future of sovereign computing
|
||||
* :doc:`Purchasing <purchasing>` - Ways to acquire an Embassy or EmbassyOS
|
||||
* :doc:`DIY Guide <diy>` - A guide on building your own Embassy
|
||||
@@ -128,7 +128,7 @@
|
||||
<p class="subscribe__heading-subheading">subscribe to our mailing list</p>
|
||||
<div class="subscribe-form">
|
||||
<form id="subscribe">
|
||||
<input type="email" id="newsletter_email" name="email" placeholder="Enter email" required>
|
||||
<input class="subscribe-input" type="email" id="newsletter_email" name="email" placeholder="Enter email" required>
|
||||
<input class="button--reverse" type="submit" value="subscribe">
|
||||
</form>
|
||||
<div class="padding-top-1" id="subscription_msg" class="hidden"></div>
|
||||
|
||||
@@ -1,21 +0,0 @@
|
||||
Miscellaneous Guides
|
||||
====================
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:hidden:
|
||||
|
||||
tor-os/index
|
||||
tor-firefox/index
|
||||
available-services
|
||||
bitcoin-cli
|
||||
|
||||
.. panel-box::
|
||||
:title: Overview
|
||||
:id: "misc-guides"
|
||||
:class: my-panel
|
||||
|
||||
* :doc:`Tor for your computer <tor-os/index>` - A guide on how to run Tor on your computer's operating system
|
||||
* :doc:`Tor for Firefox <tor-firefox/index>` - A guide on how to configure Tor for Firefox browser
|
||||
* :doc:`Bitcoin CLI <bitcoin-cli>` - Steps on how to access the command line interface of bitcoind on your Embassy
|
||||
* :doc:`Available services <available-services>` - A comprehensive list of services currently offered on EmbassyOS
|
||||
Submodule sphinx-scylladb-theme updated: f29a4500d6...ba52774017
Reference in New Issue
Block a user