From 60207b612ea41dce30184a3a8de10336fa3b68df Mon Sep 17 00:00:00 2001
From: Brendan Golden <git@brendan.ie>
Date: Sun, 22 Sep 2024 19:09:29 +0100
Subject: [PATCH] docs: moved the ssh creation to its own page

---
 _git.tar.gz                        |  4 +-
 src/skynet/services/skynet.md      | 60 +-------------------
 src/tutorials/skynet/create_ssh.md | 88 ++++++++++++++++++++++++++++++
 3 files changed, 92 insertions(+), 60 deletions(-)
 create mode 100644 src/tutorials/skynet/create_ssh.md

diff --git a/_git.tar.gz b/_git.tar.gz
index d1d674a..0f2b8ea 100644
--- a/_git.tar.gz
+++ b/_git.tar.gz
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d6013f556d117a22f35c71d78b6cc54ba3d367508d0896d7714eed909228cefe
-size 324454
+oid sha256:157aa28fbd798300534d65efd3d50063973749039a1722a9816b479327599e9e
+size 328924
diff --git a/src/skynet/services/skynet.md b/src/skynet/services/skynet.md
index 2cd4a28..eda05b7 100644
--- a/src/skynet/services/skynet.md
+++ b/src/skynet/services/skynet.md
@@ -11,64 +11,8 @@ You can find more of the history here: <https://2009.skynet.ie/history.html>
 ## Login
 Login is done via ssh and ssh keys.
 
-### Create SSH key
-First we set up the ssh folder and create a skynet folder within it for neatness
-```bash
-mkdir -f -p ~/.ssh/skynet
-cd ~/.ssh/skynet
-```
-Now we will create the ssh key itself.  
-Location: ``username``, your skynet username.  
-Password: Press Enter twice for no password on the key.  
-```bash
-ssh-keygen -t ed25519 -C "<comment>"
-```
-It will create two files: ``username`` and ``username.pub``
-
-### SSH Key
-Head over to [adding ssh keys](./account.md#ssh-keys) to find information on adding ssh keys to your skynet account.
-
-it is the ``username.pub`` that you will be adding to your account.  
-To get the contents of the file do this.
-```bash
-cat username.pub
-```
-
-### SSH Config
-Back up to the ``.ssh`` folder.
-```bash
-cd ../
-```
-
-Now we have to create the config file.  
-Notice how it has no extension.
-#### Windows
-```powershell
-"" > config
-```
-Open it up in any text editor available to you.
-
-#### Linux
-```bash
-touch config
-```
-You can edit it from command line using nano 
-
-```bash
-nano config
-```
-Or open up in a text editor.
-
-
---------------------------------------
-
-Windows and Linux pop this into the file and save it
-```
-Host *.skynet.ie
-   User %r
-   IdentityFile ~/.ssh/skynet/%r
-   IdentitiesOnly yes
-```
+## SSH Keys
+[See the tutorial on SSH keys for more info](../../tutorials/skynet/create_ssh)
 
 ### Logging in
 In any terminal do this:
diff --git a/src/tutorials/skynet/create_ssh.md b/src/tutorials/skynet/create_ssh.md
new file mode 100644
index 0000000..4c144d9
--- /dev/null
+++ b/src/tutorials/skynet/create_ssh.md
@@ -0,0 +1,88 @@
+# Setup SSH Keys
+
+To be able to gain remote access to the Skynet.
+
+``$USERNAME`` Refers to your Skynet username, for example I would replace ``$USERNAME`` with ``silver``
+
+## Create Key
+First we set up the ssh folder and create a skynet folder within it for neatness
+                
+```bash
+mkdir -f -p ~/.ssh/skynet
+cd ~/.ssh/skynet
+```
+
+Now we will create the ssh key itself.  
+Location: ``$USERNAME``, your skynet username.  
+Password: Press Enter twice for no password on the key.  
+
+```bash
+ssh-keygen -t ed25519 -C "<comment>"
+```
+It will create two files: ``$USERNAME`` and ``$USERNAME.pub`` inside ``~/.ssh/skynet``
+
+### Linux Only
+Openssh will complain if the keys permissions are too permissive.  
+To fix this use
+
+```bash
+chmod 600 $USERNAME
+# or
+chmod 600 ~/.ssh/skynet/$USERNAME
+```
+
+
+## Create Config
+Above we created a folder for Skynet keys.  
+Ye can do the same with Gitlab/Github/... in the future.  
+The only downside is that we now have to tell ssh what key to use in what situation.  
+
+
+Back up to the ``.ssh`` folder.
+```bash
+cd ../
+# or
+cd ~/.ssh
+```
+
+Now we have to create the config file.  
+Notice how it has no extension.
+
+
+### Windows
+```powershell
+"" > config
+```
+Open it up in any text editor available to you.
+
+### Linux
+```bash
+touch config
+```
+You can edit it from command line using nano
+
+```bash
+nano config
+```
+Or open up in a text editor.
+
+### Windows/Linux
+This is what we want to have in teh file.
+```
+Host *.skynet.ie
+   User $USERNAME
+   IdentityFile ~/.ssh/skynet/$USERNAME
+   IdentitiesOnly yes
+```
+
+
+
+
+## Add key to account
+Go to [the modify SSH page](https://account.skynet.ie/modify_ssh) and paste in teh contents of ``$USERNAME.pub``.
+
+You will now be able to SSH into Skynet like so:
+
+```bash
+ssh $USERNAME@skynet.skynet.ie
+```
\ No newline at end of file