Skip to content

Commit 41f0a4a

Browse files
docs: document wallet address settings in settings.md
1 parent a6bd199 commit 41f0a4a

1 file changed

Lines changed: 10 additions & 2 deletions

File tree

docs/settings.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,10 @@ The seed runs exactly once, gated on the settings table being empty.
3939
It never re-runs and never overwrites a value an admin changed later.
4040

4141
> **Note:** only the *settings* environment variables below follow this first-boot-only rule.
42-
> Infrastructure variables (database, wallet/signer addresses, ports, TLS, unlocker, …) are read
43-
> on **every** boot as usual.
42+
> Infrastructure variables (database, signer address, ports, TLS, unlocker, …) are read on
43+
> **every** boot as usual. The wallet addresses are an exception: like the other settings they
44+
> are seeded on first boot and then sourced from the stored row (env is only a fallback when the
45+
> stored value is empty).
4446
4547
## Seed environment variables
4648

@@ -73,6 +75,12 @@ is unset on first boot.
7375
| `ARKD_MIN_BUILD_VERSION_HEADER` | `build_version_header` | min accepted client build version, semver (e.g. `v2.3.4`); empty = no minimum | `""` |
7476
| `ARKD_MIN_BUILD_VERSION_HEADER_REQUIRED` | `build_version_header_required` | bool; if `true`, clients must send a valid `X-Build-Version` header (requires `build_version_header`) | `false` |
7577
| `ARKD_DIGEST_HEADER_REQUIRED` | `digest_header_required` | bool; if `true`, clients must send a matching `X-Digest` header | `false` |
78+
| `ARKD_WALLET_ADDR` | `wallet_addr` | primary arkd-wallet `host:port` | - |
79+
| `ARKD_WALLET_FALLBACK_ADDRS` | `wallet_fallback_addrs` | fallback arkd-wallet addresses, comma-separated `host:port` | - |
80+
81+
The wallet addresses follow the same first-boot-only rule as the other settings:
82+
they are read from these env vars on first boot, then the stored values win and
83+
are changed via the admin Settings API (taking effect on the next restart).
7684

7785
### Notes on specific values
7886

0 commit comments

Comments
 (0)