File tree Expand file tree Collapse file tree 1 file changed +42
-1
lines changed
Expand file tree Collapse file tree 1 file changed +42
-1
lines changed Original file line number Diff line number Diff line change @@ -9,6 +9,39 @@ letting stow create a bunch of symbolic links but it allows greater control
99and ease-of-use for managing differences across systems and dealing with
1010secrets.
1111
12+ ## usage
13+
14+ ### setup
15+
16+ You must have the GPG key used for decrypting the vault (more information
17+ below) available before running the setup step below. If you're using using a
18+ yubikey to store the key material you're done as the setup script automatically
19+ loads the public keys necessary for it to work.
20+
21+ If you're keeping the private key material on the machine then you need to copy
22+ the private key to the new machine and then run the following steps:
23+
24+ ``` shell
25+ gpg --import ./path/to/key.asc
26+ ```
27+
28+ Then you need to edit the key to give it ` ultimate ` trust:
29+
30+ ``` shell
31+ gpg --edit-key 36FDA306
32+ ```
33+
34+ Then enter ` trust ` and ` 5 ` to ` ultimate ` ly trust the key, and then ` save ` to
35+ exit.
36+
37+ You can verify success with
38+
39+ ``` shell
40+ gpg --list-keys
41+ ```
42+
43+ ### first run
44+
1245Get up and running by either cloning this repository and running, ` run.bash ` ,
1346or all-in-one:
1447
@@ -23,7 +56,15 @@ unlocked (`ssh-add ~/.ssh/key`).
2356The initial installation will install the dotfiles into ` $HOME/.dotfiles ` and
2457afterwards everything can be updated with ` git pull ` and ` ./run.bash ` .
2558
26- ## vault
59+ ### post-setup
60+
61+ Some roles only install basic configuration but other steps are necessary.
62+ For example to activate ` atuin ` (in the ` zsh ` role) you must run the ` command ` .
63+ More information is available in the ` zsh ` role README.
64+
65+ ## notes
66+
67+ ### vault
2768
2869Sensitive files are encrypted with ansible-vault. The vault password was
2970initialized like so:
You can’t perform that action at this time.
0 commit comments