add ssh help for mac and windows (forked from tilde.team wiki)

docs/help.md

@@ -44,8 +44,6 @@ your ssh directory is: `~/.ssh/` this includes the following files.
 - the `authorized_keys`-file is a list of public keys (one per line) that are allowed to log in to your user account.
 - `id_ed25519` or `id_rsa` are each private keys, and `id_ed25519.pub` or `id_rsa.pub` are the corresponding pubkey.
 
-- **[ssh windows usage](inc/ssh-windows.md)**
-
 envs.net ED25519 key fingerprint is `SHA256:V+mXTsRJ+jfJMxxPlD/28dpWouuns3Wuqwppv6ykVC8` and for<br />
 RSA `SHA256:7dB470mfzlyhhtqmjnXciIxp+jWLACiYKC3EE/Z0lFg`.
 
@@ -67,6 +65,9 @@ or for the secondary ip:<br />
 <br />
 ***if you have a slightly shaky connection then you can also use `mosh`.***
 
+- [ssh windows usage](inc/ssh-windows.md)
+- [ssh mac usage](inc/ssh-mac.md)
+
 ### create a ssh-key
 make sure you have a `~/.ssh directory`<br />
 &nbsp;&nbsp;`mkdir -m 700 ~/.ssh`

docs/inc/ssh-mac.md

@@ -0,0 +1,43 @@
+# ssh - mac usage
+
+## generating your keypair
+
+1. open terminal (it's in `/Applications/Utilities`)
+
+2. create your .ssh directory:
+
+```bash
+mkdir -m 700 ~/.ssh
+```
+
+3. create your keys:
+
+for dd25519 keys:
+
+```bash
+ssh-keygen -t ed25519 -a 100
+```
+
+for rsa keys:
+
+```bash
+ssh-keygen -t rsa -b 4096
+```
+
+4. if you press enter to accept the defaults, your public and private key will
+be located at `~/.ssh/id_ed25519.pub` and `~/.ssh/id_ed25519` respectively (or
+`~/.ssh/id_rsa.pub` and `~/.ssh/id_rsa` if you chose rsa type)
+
+5. `cat ~/.ssh/id_ed25519.pub` (or `cat ~/.ssh/id_rsa.pub` for rsa)
+
+6. copy the output of the last command and paste it in the sshkey field on the signup form.
+
+## using your keypair
+
+7. open terminal (it's in `/Applications/Utilities`)
+
+8. `ssh` to envs.net:
+
+```bash
+ssh username@envs.net
+```

docs/inc/ssh-windows.md

@@ -1 +1,97 @@
 # ssh - windows usage
+
+## windows 10
+
+windows 10 1809 or later has openssh built in, so you no longer need to install third-party tools. if openssh is not enabled, please see microsoft's documentation on [openssh in windows](https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_overview).
+
+### generating your keypair
+
+1. open your new shell
+
+2. create your .ssh directory
+
+```powershell
+mkdir .ssh
+```
+
+3. create your keypair
+
+for ed25519 keys:
+
+```powershell
+ssh-keygen -t ed25519 -a 100
+```
+
+for rsa keys:
+
+```powershell
+ssh-keygen -t rsa -b 4096
+```
+
+4. if you press enter to accept the defaults, your public and private key will
+be located at `%UserProfile%\.ssh\id_ed25519.pub` and `%UserProfile%\.ssh\id_ed25519` respectively (or
+`%UserProfile%\.ssh\id_rsa.pub` and `%UserProfile$\.ssh\id_rsa` if you chose rsa type)
+
+5. `type %UserProfile%\.ssh\id_ed25519.pub` (or `type %UserProfile%\.ssh\id_rsa.pub` for rsa)
+
+6. copy the output of the last command and paste it in the sshkey field on the signup form.
+
+### using your keypair
+
+7. open powershell (right click start button and select "windows powershell")
+
+8. `ssh` to envs.net:
+
+```bash
+ssh username@envs.net
+```
+
+---
+
+## legacy windows
+
+older versions of windows unfortunately do not come with openssh, and you will need to install a third-party tool. you may choose from any of the following options:
+
+- [windows subsystem for linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10)
+- [msys2](http://www.msys2.org/)
+- [git bash](https://git-scm.com)
+
+1. open your new shell
+
+2. create your .ssh directory
+
+```bash
+mkdir .ssh
+```
+
+3. create your keypair
+
+for ed25519 keys:
+
+```bash
+ssh-keygen -t ed25519 -a 100
+```
+
+for rsa keys:
+
+```bash
+ssh-keygen -t rsa -b 4096
+```
+
+4. if you press enter to accept the defaults, your public and private key will
+be located at `~/.ssh/id_ed25519.pub` and `~/.ssh/id_ed25519` respectively (or
+`~/.ssh/id_rsa.pub` and `~/.ssh/id_rsa` if you chose rsa type)
+
+5. `cat ~/.ssh/id_ed25519.pub` (or `cat ~/.ssh/id_rsa.pub` for rsa)
+
+6. copy the output of the last command and paste it in the sshkey field on the signup form.
+
+### using your keypair
+
+7. open terminal (location will vary depending on your choice)
+
+8. `ssh` to envs.net:
+
+```bash
+ssh username@envs.net
+```