diff options
Diffstat (limited to 'docs/configuration.md')
| -rw-r--r-- | docs/configuration.md | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/configuration.md b/docs/configuration.md index f48f288..1b7bd44 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -257,6 +257,21 @@ record = "/home/tv/.config/continuum/tv.record" continuum-party --config tv.toml write home/tv/motd '"hello"' ``` +Without `--config`, the client reads a federation's own directory, as one party may vote +in several federations: `~/.config/continuum/federations/NAME/` (in `$XDG_CONFIG_HOME` +where that is set), holding its `party.toml` of the options above, its record (`record`), +and, where given there, its key (`key`); `record` and `key` in `party.toml`, or on the +command line, win over those. `--federation NAME` chooses one; where there is only one, +the client uses it without being told, and where there are several, it asks which. +`init --federation NAME` begins one, its `party.toml` holding the options given with it +(`node`, `token`, `key`, the key's path made absolute), readable by its owner alone: + +```sh +continuum-party --federation krebs --node http://tv:secret@localhost:3000 \ + --key tv.key init tv --root root +continuum-party vote 8d02 yes # krebs, the only one +``` + `key` is an OpenSSH private key file, or a public key an ssh-agent holds: the key itself (`key = "ecdsa-sha2-nistp256 AAAA…"`), or a file of such lines, whose first signs ([`guides/federation/keys.md`](guides/federation/keys.md), |
