refactor: finish moving ssh-* scripts to own installers
[webi-installers/.git] / ssh-pubkey / README.md
1 ---
2 title: SSH Pub Key
3 homepage: https://webinstall.dev/ssh-pubkey
4 tagline: |
5   Get your SSH public key.
6 ---
7
8 ## Cheat Sheet
9
10 > Your SSH Public Key is used for secure login from your laptop to servers and
11 > other network devices - such as Raspberry Pis, game consoles, and home cloud
12 > systems. The file public key _always_ ends in `.pub`.
13
14 `ssh-pubkey` will:
15
16 1. Create a new ssh keypair if you don’t already have one
17 2. Copy your new or existing SSH Public Key to your `Downloads` folder
18 3. Print the location of the copied key, and its contents to the screen
19
20 The easiest way to get your SSH Public Key:
21
22 ```bash
23 curl https://webinstall.dev/ssh-pubkey | bash
24 ```
25
26 ```txt
27 ~/Downloads/id_rsa.johndoe.pub:
28
29 ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDTOhRnzDJNBNBXVCgkxkEaDM4IAp81MtE8fuqeQuFvq5gYLWoZND39N++bUvjMRCveWzZlQNxcLjXHlZA3mGj1b9aMImrvyoq8FJepe+RLEuptJe3md4EtTXo8VJuMXV0lJCcd9ct+eqJ0jH0ww4FDJXWMaFbiVwJBO0IaYevlwcf0QwH12FCARZUSwXfsIeCZNGxOPamIUCXumpQiAjTLGHFIDyWwLDCNPi8GyB3VmqsTNEvO/H8yY4VI7l9hpztE5W6LmGUfTMZrnsELryP5oRlo8W5oVFFS85Lb8bVfn43deGdlLGkwmcJuXzZfostSTHI5Mj7MWezPZyoSqFLl johndoe@MacBook-Air
30 ```
31
32 The standard location for your SSH Public Key:
33
34 ```bash
35 ~/.ssh/id_rsa.pub
36 ```
37
38 How to create an SSH Keypair if it doesn't already exist:
39
40 ```bash
41 if [ -f "$HOME/.ssh/id_rsa" ];then
42     ssh-keygen -b 2048 -t rsa -f "$HOME/.ssh/id_rsa" -q -N ""
43 fi
44 ```
45
46 How to copy your SSH Public Key to from its hidden folder to your `Downloads`
47 folder:
48
49 ```bash
50 rsync -av "$HOME/.ssh/id_rsa.pub" \
51     "$HOME/Downloads/id_rsa.$(whoami).pub"
52 ```
53
54 How to print your public key to the Terminal:
55
56 ```bash
57 cat "$HOME/Downloads/id_rsa.pub"
58 ```