From 97c3cada9266e0aebd0f97c5e9de09a7d10456fa Mon Sep 17 00:00:00 2001 From: John Newbery Date: Thu, 11 Jan 2018 16:55:06 -0500 Subject: [PATCH] [docs] Clarify -walletdir usage --- doc/release-notes.md | 34 +++++++++++++++++++++------------- 1 file changed, 21 insertions(+), 13 deletions(-) diff --git a/doc/release-notes.md b/doc/release-notes.md index d92666da7260c..fb8e0f7f5903c 100644 --- a/doc/release-notes.md +++ b/doc/release-notes.md @@ -75,19 +75,27 @@ There is a checkbox to mark the transaction as final. The RPC default remains unchanged: to use RBF, launch with `-walletrbf=1` or use the `replaceable` argument for individual transactions. -Custom wallet directories ---------------------- -The ability to specify a directory other than the default data directory in which to store -wallets has been added. An existing directory can be specified using the `-walletdir=` -argument. Wallets loaded via `-wallet` arguments must be in this wallet directory. Care should be taken -when choosing a wallet directory location, as if it becomes unavailable during operation, -funds may be lost. - -Default wallet directory change --------------------------- -On new installations (if the data directory doesn't exist), wallets will now be stored in a -new `wallets/` subdirectory inside the data directory. If this `wallets/` subdirectory -doesn't exist (i.e. on existing nodes), the current datadir root is used instead, as it was. +Wallets directory configuration (`-walletdir`) +---------------------------------------------- + +Bitcoin Core now has more flexibility in where the wallets directory can be +located. Previously wallet database files were stored at the top level of the +bitcoin data directory. The behavior is now: + +- For new installations (where the data directory doesn't already exist), + wallets will now be stored in a new `wallets/` subdirectory inside the data + directory by default. +- For existing nodes (where the data directory already exists), wallets will be + stored in the data directory root by default. If a `wallets/` subdirectory + already exists in the data directory root, then wallets will be stored in the + `wallets/` subdirectory by default. +- The location of the wallets directory can be overridden by specifying a + `-walletdir=` option where `` can be an absolute path or a + relative path (relative to the current working directory). `` can + also be a path to symlink to a directory. + +Care should be taken when choosing the wallets directory location, as if it +becomes unavailable during operation, funds may be lost. Low-level RPC changes ----------------------