Connecting to Sector Disk
=============================================================================
Written by jebug29
```
Created: 24 May 2020
Modified: 24 May 2020
```
Connecting to Sector Disk is just as easy as connecting to any other SSH server
on Port 22! This guide is (mostly) for inexperienced users and for users on
versions of Windows before Windows 10 implemented OpenSSH.

tl;dr version: `ssh user@sectordisk.pw`

Once you are logged in, use the `commands` and `help` commands to get a list of
Sector Disk-relevant commands on the system.

Operating Systems (in this guide)
-----------------------------------------------------------------------------
* Windows (via PuTTY)
* Windows 10 (via OpenSSH)
* Linux and macOS

Windows (via PuTTY)
-----------------------------------------------------------------------------
* Get PuTTY here[0]

Once you have installed and opened PuTTY, you can configure it as follows:
```
Server: sectordisk.pw
Port: 22
```
If you would like to add your username so that you don't have to re-enter
it each time you log in, simply add your username in `Connection -> Data ->
Auto-login Username`. Then give the profile a name (i.e. "sector") and save it
in `Sessions`.

!PuTTY Autologin[1]

!PuTTY Profile Config[2]

!PuTTY Connected[3]

Windows 10 (via OpenSSH)
-----------------------------------------------------------------------------
In the latest releases of Windows 10, Microsoft finally decided to include
OpenSSH as a part of the OS. If you don't want to install PuTTY or think that
it's overkill for simply SSH (which is fair), simply do the following (keyboard
shortcuts are denoted by `[]`):

(Note that I would _highly recommend_ PuTTY on Windows, but it's up to you)

Open a command prompt (`[ Winkey-R ]` -> `cmd` -> `[ Enter ]`) and then enter
the command `ssh user@sectordisk.pw`, replacing "user" with your Sector Disk
username. You will then be shown the Sector Disk ssh banner and prompted to
enter your password. Type your password and press enter, and you'll log in!

!Run Prompt[4]

!SSH via CMD[5]

If the ssh command does not work, you may not have OpenSSH enabled on Windows.
For me it was enabled by default, but it may not for all users. If this is the
case, either look up how to enable OpenSSH in Windows 10 or simply use PuTTY.

_Note that nothing will display while you're typing your password. This is to
protect the length of your password from being seen by on-lookers or exposed by
logs!_

Linux and macOS
-----------------------------------------------------------------------------
Most Unix-like operating systems and all versions of macOS (OS X) come
pre-installed with OpenSSH by default. First, open your terminal (keyboard
shortcuts are denoted in square brackets `[]`):

On macOS: `[ Command-Space ]` -> `Terminal` -> `[ Enter ]`

On Ubuntu Linux: `[ Ctrl-Alt-T ]`

And then enter the command `ssh user@sectordisk.pw`, replacing "user" with your
Sector Disk username. You will then be shown the Sector Disk ssh banner and
prompted to enter your password. Type your password and press enter, and you'll
log in!

!macOS Spotlight[6]
!macOS Terminal[7]

_Note that nothing will display while you're typing your password. This is to
protect the length of your password from being seen by on-lookers or exposed by
logs!_

[0] https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
[1] gopher://sectordisk.pw/I/tutorials/connection-guide/sd-putty-2.PNG
[2] gopher://sectordisk.pw/I/tutorials/connection-guide/sd-putty-3.PNG
[3] gopher://sectordisk.pw/I/tutorials/connection-guide/sd-putty-4.PNG
[4] gopher://sectordisk.pw/I/tutorials/connection-guide/cmd-1.PNG
[5] gopher://sectordisk.pw/I/tutorials/connection-guide/cmd-2.PNG
[6] gopher://sectordisk.pw/I/tutorials/connection-guide/macos-1.png
[7] gopher://sectordisk.pw/I/tutorials/connection-guide/macos-3.png