Skip to content

Commit 97c3cad

Browse files
committed
[docs] Clarify -walletdir usage
1 parent 0910cbe commit 97c3cad

File tree

1 file changed

+21
-13
lines changed

1 file changed

+21
-13
lines changed

doc/release-notes.md

Lines changed: 21 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -75,19 +75,27 @@ There is a checkbox to mark the transaction as final.
7575
The RPC default remains unchanged: to use RBF, launch with `-walletrbf=1` or
7676
use the `replaceable` argument for individual transactions.
7777

78-
Custom wallet directories
79-
---------------------
80-
The ability to specify a directory other than the default data directory in which to store
81-
wallets has been added. An existing directory can be specified using the `-walletdir=<dir>`
82-
argument. Wallets loaded via `-wallet` arguments must be in this wallet directory. Care should be taken
83-
when choosing a wallet directory location, as if it becomes unavailable during operation,
84-
funds may be lost.
85-
86-
Default wallet directory change
87-
--------------------------
88-
On new installations (if the data directory doesn't exist), wallets will now be stored in a
89-
new `wallets/` subdirectory inside the data directory. If this `wallets/` subdirectory
90-
doesn't exist (i.e. on existing nodes), the current datadir root is used instead, as it was.
78+
Wallets directory configuration (`-walletdir`)
79+
----------------------------------------------
80+
81+
Bitcoin Core now has more flexibility in where the wallets directory can be
82+
located. Previously wallet database files were stored at the top level of the
83+
bitcoin data directory. The behavior is now:
84+
85+
- For new installations (where the data directory doesn't already exist),
86+
wallets will now be stored in a new `wallets/` subdirectory inside the data
87+
directory by default.
88+
- For existing nodes (where the data directory already exists), wallets will be
89+
stored in the data directory root by default. If a `wallets/` subdirectory
90+
already exists in the data directory root, then wallets will be stored in the
91+
`wallets/` subdirectory by default.
92+
- The location of the wallets directory can be overridden by specifying a
93+
`-walletdir=<path>` option where `<path>` can be an absolute path or a
94+
relative path (relative to the current working directory). `<path>` can
95+
also be a path to symlink to a directory.
96+
97+
Care should be taken when choosing the wallets directory location, as if it
98+
becomes unavailable during operation, funds may be lost.
9199

92100
Low-level RPC changes
93101
----------------------

0 commit comments

Comments
 (0)