SDK, dev docs images, SSH-over-Tor, Misc edits

This commit is contained in:
kn0wmad
2022-01-28 16:06:43 -07:00
committed by Lucy Cifferello
parent 9233b97424
commit b908e782e4
13 changed files with 131 additions and 69 deletions

View File

@@ -30,7 +30,7 @@ Linux
sudo systemctl restart tor
.. group-tab:: Arch / Manjaro
.. group-tab:: Arch / Manjaro / Garuda
Simply install Tor with:

View File

@@ -1,7 +1,7 @@
.. _initial-setup:
=============
Initial Setup - ***COMPACT / SIMPLIFY??***
Initial Setup
=============
Connect and Power Up

View File

@@ -1,9 +1,13 @@
.. _recover-02x:
===================================
Migrate Embassy from Versions 0.2.x - **NEEDS SCREENS**
Migrate Embassy from Versions 0.2.x
===================================
.. contents::
:depth: 4
:local:
Migrate Embassy Series 0.2.x Data
---------------------------------

View File

@@ -1,7 +1,7 @@
.. _shoot-embassy:
=======================
Troubleshooting Embassy - ***ADD LIST OF SOUNDS***
Troubleshooting Embassy
=======================
Hardware
@@ -11,7 +11,7 @@ Embassy is making noises
========================
The plug and play Embassy sold by Start9 has no moving parts, so the only noises it should ever make would come from its internal speaker. The following is a list of all possible sounds:
#.
#.
Embassy boots into "Diagnostic Mode"
====================================

View File

@@ -4,3 +4,68 @@
SSH Over Tor
============
.. note:: The following guide requires that you have already added an `SSH key to your Embassy<ssh-setup>`.
This is currently only supported on Linux, but may work on Windows with `Torifier <https://torifier.com/>`_.
Setup
-----
#. First, you'll need one dependency, ``torsocks``, which will allow you to use SSH over Tor on the machine that you want access with. Select your Linux flavor to install:
.. tabs::
.. group-tab:: Debian / Ubuntu
.. code-block:: bash
apt install torsocks
.. group-tab:: Arch / Manjaro / Garuda
.. code-block:: bash
pacman -S torsocks
#. SSH in:
.. code-block:: bash
ssh root@embassy-xxxxxxx.local
#. Add the following 2 lines to ``/etc/tor/torrc`` **EITHER** by using your preferred text editor:
``HiddenServiceDir /var/lib/tor/ssh``
``HiddenServicePort 22 127.0.0.1:22``
**OR** by entering the following 2 commands:
.. code-block:: bash
echo "HiddenServiceDir /var/lib/tor/ssh" >> /etc/tor/torrc
echo "HiddenServicePort 22 127.0.0.1:22" >> /etc/tor/torrc
#. Then reload the Tor configuration with your edits:
.. code-block:: bash
systemctl reload tor
#. Next, gather the ``.onion`` address you just created:
.. code-block:: bash
cat /var/lib/tor/ssh/hostname
.. note:: All these changes are on the overlay and won't persist after a restart of your Embassy
#. Add an additional SSH key in your EmbassyUI if you want to access from a machine other than the one you did this setup with.
Access
------
Now to log in, simply use the following command, using the ``.onion`` hostname you printed above:
.. code-block::
torsocks ssh root@xxxxxxxxxxxxxxxxx.onion