Skip to content

Commit 3eaaf71

Browse files
committed
Merge pull request #6532
8778471 Update init doc to mention cookie authentication (fanquake)
2 parents 6bb2805 + 8778471 commit 3eaaf71

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

doc/init.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,15 @@ file, however it is recommended that a strong and secure password be used
2929
as this password is security critical to securing the wallet should the
3030
wallet be enabled.
3131

32-
If bitcoind is run with "-daemon" flag, and no rpcpassword is set, it will
33-
print a randomly generated suitable password to stderr. You can also
34-
generate one from the shell yourself like this:
32+
If bitcoind is run with the "-server" flag (set by default), and no rpcpassword is set,
33+
it will use a special cookie file for authentication. The cookie is generated with random
34+
content when the daemon starts, and deleted when it exits. Read access to this file
35+
controls who can access it through RPC.
3536

36-
`bash -c 'tr -dc a-zA-Z0-9 < /dev/urandom | head -c32 && echo'`
37+
By default the cookie is stored in the data directory, but it's location can be overridden
38+
with the option '-rpccookiefile'.
3739

38-
Once you have a password in hand, set `rpcpassword=` in `/etc/bitcoin/bitcoin.conf`
40+
This allows for running bitcoind without having to do any manual configuration.
3941

4042
`conf`, `pid`, and `wallet` accept relative paths which are interpreted as
4143
relative to the data directory. `wallet` *only* supports relative paths.

0 commit comments

Comments
 (0)