refactor: finish moving ssh-* scripts to own installers
[webi-installers/.git] / ssh-utils / README.md
1 ---
2 title: SSH Utils
3 homepage: https://webinstall.dev/ssh-utils
4 tagline: |
5   SSH Utils: Because --help takes to long.
6 ---
7
8 ## Cheat Sheet
9
10 > SSH Utils includes shortcut commands for some common tasks, including
11 > `ssh-pubkey`, `ssh-setpass`, and `ssh-adduser`
12
13 **ssh-pubkey**:
14
15 `ssh-pubkey` will make sure you have an SSH key, and then print it to the screen
16 and place it in `~/Downloads`.
17
18 ```bash
19 ssh-pubkey
20 ```
21
22 ```txt
23 ~/Downloads/id_rsa.johndoe.pub:
24
25 ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDTOhRnzDJNBNBXVCgkxkEaDM4IAp81MtE8fuqeQuFvq5gYLWoZND39N++bUvjMRCveWzZlQNxcLjXHlZA3mGj1b9aMImrvyoq8FJepe+RLEuptJe3md4EtTXo8VJuMXV0lJCcd9ct+eqJ0jH0ww4FDJXWMaFbiVwJBO0IaYevlwcf0QwH12FCARZUSwXfsIeCZNGxOPamIUCXumpQiAjTLGHFIDyWwLDCNPi8GyB3VmqsTNEvO/H8yY4VI7l9hpztE5W6LmGUfTMZrnsELryP5oRlo8W5oVFFS85Lb8bVfn43deGdlLGkwmcJuXzZfostSTHI5Mj7MWezPZyoSqFLl johndoe@MacBook-Air
26 ```
27
28 **ssh-adduser**:
29
30 Many modern web programs (`npm` and `postgres`, for example) will not function
31 correctly if run as root. `ssh-adduser` adds user `app` with the same
32 **`~/.ssh/authorized_keys`** as the `root` user, with a long random password,
33 and gives `app` `sudo` privileges.
34
35 **ssh-setpass**:
36
37 `ssh-setpass` will ask you for your old passphrase (if any) and then for the new
38 one to reset it with.