aboutsummaryrefslogtreecommitdiffstats
path: root/docs/configuration.md
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-17 16:18:58 +0000
committertv <tv@krebsco.de>2026-11-17 17:36:10 +0100
commit7fc844ff0167fb0943e3fa85af671d8f3bbf005d (patch)
treeea7a759bfdfbd1705b64f6a1083ae42d9c84515c /docs/configuration.md
parente9b1ea18694c88abe1e31f8236f8d8beb6362be9 (diff)
continuum-party: options from configuration files, as the node's
`continuum-party` takes its options (`node`, `token`, `key`, `record`: `config::PARTY_OPTIONS`) on the command line and in configuration files of the node's format: `--config`, repeatable, arguments winning, `--unset`, includes and imports. The configuration's loader takes the options it reads as a table (`config::with_options`, `config::merged`, `file::load_with`), the node's or the client's, and a key naming none of them is an error in either; `node` and `token` are secrets, never logged.
Diffstat (limited to 'docs/configuration.md')
-rw-r--r--docs/configuration.md19
1 files changed, 19 insertions, 0 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.