mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-04-01 21:13:10 +00:00
SDK, dev docs images, SSH-over-Tor, Misc edits
This commit is contained in:
@@ -30,7 +30,7 @@ Linux
|
||||
|
||||
sudo systemctl restart tor
|
||||
|
||||
.. group-tab:: Arch / Manjaro
|
||||
.. group-tab:: Arch / Manjaro / Garuda
|
||||
|
||||
Simply install Tor with:
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
.. _initial-setup:
|
||||
|
||||
=============
|
||||
Initial Setup - ***COMPACT / SIMPLIFY??***
|
||||
Initial Setup
|
||||
=============
|
||||
|
||||
Connect and Power Up
|
||||
|
||||
@@ -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
|
||||
---------------------------------
|
||||
|
||||
|
||||
@@ -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"
|
||||
====================================
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user