summaryrefslogtreecommitdiff
path: root/secrets/README.md
diff options
context:
space:
mode:
authorIgor Soarez <igor@soarez.org>2026-11-21 13:24:26 +0000
committerIgor Soarez <igor@soarez.org>2026-11-21 13:24:26 +0000
commit990a23be281ee13e33c165f446d2ac3c0c88299c (patch)
treefc05055a29b8bedb6a3121cb5bf808f9c17c9a38 /secrets/README.md
parentc159f7526224d6dca42a456162e1b116083751df (diff)
szecret create-local <bucket>/<store>: a new store's key goes in a bucket this machine reads; plain <store> for an existing store or no bucketsHEADmaster
Diffstat (limited to 'secrets/README.md')
-rw-r--r--secrets/README.md9
1 files changed, 6 insertions, 3 deletions
diff --git a/secrets/README.md b/secrets/README.md
index 5e98f3f..69fd53c 100644
--- a/secrets/README.md
+++ b/secrets/README.md
@@ -31,7 +31,8 @@ szecret list
| `enrol [--tpm\|--se]` | Make this machine's identity and print its public key |
| `ready` | Check there is a store and an identity |
| `ensure` | Ensure the old private key is configured (interactive) |
-| `create-local <name> <dir>` | Create a localized secret store (the old kind) |
+| `create-local <bucket>/<name> <dir>` | Create a localized secret store, its key in `<bucket>`, which this machine must read |
+| `create-local <name> <dir>` | The same for an existing store, or on a machine with no buckets |
| `put-local <file>` | Encrypt to a local store or a repository bucket |
| `get-local <file>` | Decrypt from a local store or a repository bucket |
@@ -82,10 +83,12 @@ Local stores allow you to keep encrypted secrets outside the global store, usefu
```bash
# Initialize a local store in a directory
-szecret create-local myproject /path/to/project/secrets/
+szecret create-local web-hosts/myproject /path/to/project/secrets/
# This creates:
-# - A key in the global store (local-key-myproject)
+# - A key, local-key-myproject, in the bucket web-hosts: that bucket's
+# readers read the store (on a machine with no buckets,
+# `create-local myproject <dir>` puts it in the global store)
# - A metadata file at /path/to/project/secrets/.szecret containing:
# store=myproject
# pubkey=age1...