aboutsummaryrefslogtreecommitdiffstats
path: root/docs/example.toml
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-16 20:06:42 +0000
committertv <tv@krebsco.de>2026-11-16 21:26:29 +0100
commit9d18983e4b643eac04de49a42a6f29805570dba3 (patch)
tree90bff68e2b2ec5e3bbbd3fee974c53ff44dcbe32 /docs/example.toml
parentd8cec1cd61c63659d583168244f8f51ec550b3be (diff)
federation: a pinned checkpoint, found in the document
Once a store moved to a checkpoint, a node reading it from the root could take what was grown anew from the root since, by keys of versions long replaced: so its operator pins the checkpoint (`--store-checkpoint`, by its ID), and the node reads its store from there whenever it starts (`docs/store.md`, Pinned checkpoints). It finds it in its document: at heads a proposal's version names, built from their history read from the root, as any node builds the checkpoint it moves to (`Store::checkpoint_at`), the one whose ID is pinned. Until the document holds it, the node holds no store, and says so once.
Diffstat (limited to 'docs/example.toml')
-rw-r--r--docs/example.toml6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/example.toml b/docs/example.toml
index c21158f..26f0ba2 100644
--- a/docs/example.toml
+++ b/docs/example.toml
@@ -132,6 +132,12 @@ htpasswd = "/etc/continuum/htpasswd"
# anew from the document, may take what it refused.
# store-file = "/var/lib/continuum/store.json"
+# Behind the `federation` feature, with store-root or store-id: a checkpoint of the store,
+# by its ID, from which the node reads its store whenever it starts, found in its
+# document; once the store moved to a checkpoint, reading from the root could take what
+# was grown anew from it since, by keys of versions long replaced.
+# store-checkpoint = "…"
+
# SSH keys, as authorized_keys lines (ssh-ed25519 <base64> [comment]), whose signature
# on a strict remake's manifest this node takes: the values kept when the swarm turns
# strict (docs/access.md). Without, it votes for no strict remake; a majority of the