aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/configuration.md19
-rw-r--r--docs/guides/federation/getting-started.md6
2 files changed, 24 insertions, 1 deletions
diff --git a/docs/configuration.md b/docs/configuration.md
index d3f7e56..d246082 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -238,3 +238,22 @@ placeholders is shown as written instead.
```sh
continuum --config /etc/continuum.toml --print-config | jq .options.seeds
```
+
+## The party's client
+
+`continuum-party` (with the `federation` feature) takes its options, `node`, `token`,
+`key` and `record`, the same ways: on the command line, and in configuration files of
+the same format (`--config`, repeatable, later files winning, arguments winning over
+them; `--unset`; includes and imports), whose keys are those options alone:
+
+```toml
+node = "http://tv:${file:/run/secrets/tv-password}@localhost:3000"
+key = "/home/tv/.config/continuum/tv.key"
+record = "/home/tv/.config/continuum/tv.record"
+```
+
+```sh
+continuum-party --config tv.toml write home/tv/motd '"hello"'
+```
+
+`node` and `token` are secrets: never logged, however they are given.
diff --git a/docs/guides/federation/getting-started.md b/docs/guides/federation/getting-started.md
index 8ce4c19..5d46192 100644
--- a/docs/guides/federation/getting-started.md
+++ b/docs/guides/federation/getting-started.md
@@ -114,7 +114,11 @@ continuum-party --node http://tv:secret@localhost:3000 --key tv.key --record tv.
# 3a9f… taken
```
-The value is JSON. lass reads it on its node, with everything else that counts:
+The value is JSON. The client's options can go in a configuration file instead, as the
+node's do ([`configuration.md`](../../configuration.md), The party's client):
+`continuum-party --config tv.toml write …`.
+
+lass reads it on its node, with everything else that counts:
```sh
curl -s -u lass:secret localhost:3000/events/counts | jq .values