aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorWladimir J. van der Laan <laanwj@gmail.com>2015-08-10 18:01:52 +0200
committerWladimir J. van der Laan <laanwj@gmail.com>2015-08-10 18:02:10 +0200
commit3eaaf71fe76b659d8ed40fdf88ce1ba18b62cc36 (patch)
tree44a826ac2f085a8daac16aff60df09962c0fc776 /doc
parent6bb28058d3ede4ff0b8e6d5315f0c2386f3e1131 (diff)
parent8778471dceb01e3ace825bdb5a3f59ff8d6f2b4f (diff)
downloadbitcoin-3eaaf71fe76b659d8ed40fdf88ce1ba18b62cc36.tar.xz
Merge pull request #6532
8778471 Update init doc to mention cookie authentication (fanquake)
Diffstat (limited to 'doc')
-rw-r--r--doc/init.md12
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/init.md b/doc/init.md
index 7dee450c29..ed9ce72154 100644
--- a/doc/init.md
+++ b/doc/init.md
@@ -29,13 +29,15 @@ file, however it is recommended that a strong and secure password be used
as this password is security critical to securing the wallet should the
wallet be enabled.
-If bitcoind is run with "-daemon" flag, and no rpcpassword is set, it will
-print a randomly generated suitable password to stderr. You can also
-generate one from the shell yourself like this:
+If bitcoind is run with the "-server" flag (set by default), and no rpcpassword is set,
+it will use a special cookie file for authentication. The cookie is generated with random
+content when the daemon starts, and deleted when it exits. Read access to this file
+controls who can access it through RPC.
-`bash -c 'tr -dc a-zA-Z0-9 < /dev/urandom | head -c32 && echo'`
+By default the cookie is stored in the data directory, but it's location can be overridden
+with the option '-rpccookiefile'.
-Once you have a password in hand, set `rpcpassword=` in `/etc/bitcoin/bitcoin.conf`
+This allows for running bitcoind without having to do any manual configuration.
`conf`, `pid`, and `wallet` accept relative paths which are interpreted as
relative to the data directory. `wallet` *only* supports relative paths.