diff options
| author | Wladimir J. van der Laan <laanwj@gmail.com> | 2015-08-10 18:01:52 +0200 |
|---|---|---|
| committer | Wladimir J. van der Laan <laanwj@gmail.com> | 2015-08-10 18:02:10 +0200 |
| commit | 3eaaf71fe76b659d8ed40fdf88ce1ba18b62cc36 (patch) | |
| tree | 44a826ac2f085a8daac16aff60df09962c0fc776 | |
| parent | 6bb28058d3ede4ff0b8e6d5315f0c2386f3e1131 (diff) | |
| parent | 8778471dceb01e3ace825bdb5a3f59ff8d6f2b4f (diff) | |
Merge pull request #6532
8778471 Update init doc to mention cookie authentication (fanquake)
| -rw-r--r-- | doc/init.md | 12 |
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. |