wiki/pages/sshkeys.md

SSH Keys

how to make an ssh key

SSH supports a handful of types of cryptographic keys. The most used are RSA and the more modern Ed25519.

RSA is the de-facto standard and is supported everywhere (just choose a big enough key like 4096bits to be secure). Ed25519 is designed to be faster and smaller without sacrificing security, so is best suited for embedded devices or machines with low resources. It's supported on tilde (and really on any modern system) but you may find older systems which do not support it.

Below you'll find instructions to generate either type (or both if you want).

Keep in mind that these instructions leave your private keys unencrypted in your local hard disk. So keep them private; never share them. A good solution is to provide a password for them at creation time, but this implies entering a password any time you used them (impractical) or use something like ssh-agent (a bit more complex)

We don't have documentation for this (yet) so either go with no password keys, or ask on IRC (#radiofreqs) for help.

pick your fighter: [mac] | [windows] | [linux]

---

mac

generating your keypair

1. open terminal (it's in /Applications/Utilities)

2. create your .ssh directory:

mkdir -m 700 ~/.ssh

1. create your keys:

for rsa keys:

ssh-keygen -t rsa -b 4096

for ed25519 keys:

ssh-keygen -t ed25519 -a 100

1. if you press enter to accept the defaults, your public and private key will be located at ~/.ssh/id_rsa.pub and ~/.ssh/id_rsa respectively (or ~/.ssh/id_ed25519.pub and ~/.ssh/id_ed25519 if you chose ed25519 type)

2. cat ~/.ssh/id_rsa.pub (or cat ~/.ssh/id_ed25519.pub for ed25519)

3. copy the output of the last command and paste it in the sshkey field on the signup form (or email it to admins if you already have an account)

using your keypair

once nonlinear or another admin approves your signup, you can join radiofreqs.space

1. open terminal (it's in /Applications/Utilities)

2. ssh to radiofreqs.space:

ssh username@radiofreqs.space

where username is your username (nonlinear would use ssh nonlinear@radiofreqs.space)

1. profit???

---

windows

there are a couple options for using ssh on windows these days. i like to use git bash.

generating your keypair

choose from any of the following options:

• windows subsystem for linux
• msys2
• git bash

1. open your new shell

2. create your .ssh directory

mkdir .ssh

1. create your keypair

for rsa keys:

ssh-keygen -t rsa -b 4096

for ed25519 keys:

ssh-keygen -t ed25519 -a 100

1. if you press enter to accept the defaults, your public and private key will be located at ~/.ssh/id_rsa.pub and ~/.ssh/id_rsa respectively (or ~/.ssh/id_ed25519.pub and ~/.ssh/id_ed25519 if you chose ed25519 type)

2. cat ~/.ssh/id_rsa.pub (or cat ~/.ssh/id_ed25519.pub for ed25519)

3. copy the output of the last command and paste it in the sshkey field on the signup form (or email it to admins if you already have an account)

using your keypair

once nonlinear or another admin approves your signup, you can join radiofreqs.space

1. open terminal (it's in /Applications/Utilities)

2. ssh to radiofreqs.space:

ssh username@radiofreqs.space

where username is your username (nonlinear would use ssh nonlinear@radiofreqs.space)

1. profit???

---

linux

there are a lot of linux distros, but ssh and ssh-keygen should be available in almost all cases. if they're not, look up how to install ssh for your distro.

generating your keypair

1. make sure you have a ~/.ssh directory

mkdir -m 700 ~/.ssh

1. create your keys

for rsa keys:

ssh-keygen -t rsa -b 4096

for ed25519 keys:

ssh-keygen -t ed25519 -a 100

1. if you press enter to accept the defaults, your public and private key will be located at ~/.ssh/id_rsa.pub and ~/.ssh/id_rsa respectively (or ~/.ssh/id_ed25519.pub and ~/.ssh/id_ed25519 if you chose ed25519 type)

2. cat ~/.ssh/id_rsa.pub (or cat ~/.ssh/id_ed25519.pub for ed25519)

3. copy the output of the last command and paste it in the sshkey field on the signup form (or email it to admins if you already have an account)

using your keypair

once nonlinear or another admin approves your signup, you can join radiofreqs.space

1. open a terminal (this depends on your distro)

2. ssh to radiofreqs.space:

ssh username@radiofreqs.space

where username is your username (nonlinear would use ssh nonlinear@radiofreqs.space)

1. profit???

---

this tutorial is taken from radiofreqs.space ssh wiki page uses parts of the tilde.club ssh primer and the tilde.town ssh guide.

back