docs: moved the ssh creation to its own page
This commit is contained in:
parent
52b8dd70da
commit
60207b612e
3 changed files with 92 additions and 60 deletions
BIN
_git.tar.gz
(Stored with Git LFS)
BIN
_git.tar.gz
(Stored with Git LFS)
Binary file not shown.
|
@ -11,64 +11,8 @@ You can find more of the history here: <https://2009.skynet.ie/history.html>
|
||||||
## Login
|
## Login
|
||||||
Login is done via ssh and ssh keys.
|
Login is done via ssh and ssh keys.
|
||||||
|
|
||||||
### Create SSH key
|
## SSH Keys
|
||||||
First we set up the ssh folder and create a skynet folder within it for neatness
|
[See the tutorial on SSH keys for more info](../../tutorials/skynet/create_ssh)
|
||||||
```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
|
|
||||||
```
|
|
||||||
|
|
||||||
### Logging in
|
### Logging in
|
||||||
In any terminal do this:
|
In any terminal do this:
|
||||||
|
|
88
src/tutorials/skynet/create_ssh.md
Normal file
88
src/tutorials/skynet/create_ssh.md
Normal file
|
@ -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
|
||||||
|
```
|
Loading…
Reference in a new issue