Skip to content

Commit a199f75

Browse files
committed
Merge #16857: doc: Elaborate need to re-login on Debian-based after usermod for Tor group
7063401 Elaborate on the need to re-login on Debian-based systems to use tor following usermod (clashicly) Pull request description: Starting bitcoind with `-onlynet=onion` immediately after adding bitcoind user to debian-tor group will yield the following notice on debug.log: "tor: Authentication cookie /run/tor/control.authcookie could not be opened (check permissions)" Elaborate on the need to re-login to ensure debian-tor group has been applied to bitcoind user after: sudo usermod -a -G debian-tor username Verification can be done via `groups` command in shell. Otherwise operator may not be aware at first launch they are not running a tor enabled node. ACKs for top commit: fanquake: ACK 7063401 - Thanks for following up. Tree-SHA512: 3473966fb43b4f1c86bd8841dd6ea8c2798256c2ca926b10bd08cd655b954a9e77f0278c4fe63160e69cc75e240a3580af00ea46bf960fde2788aa88f03510b2
2 parents 884f7cc + 7063401 commit a199f75

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

doc/tor.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,10 @@ preconfigured and the creation of a hidden service is automatic. If permission p
114114
are seen with `-debug=tor` they can be resolved by adding both the user running Tor and
115115
the user running bitcoind to the same group and setting permissions appropriately. On
116116
Debian-based systems the user running bitcoind can be added to the debian-tor group,
117-
which has the appropriate permissions.
117+
which has the appropriate permissions. Before starting bitcoind you will need to re-login
118+
to allow debian-tor group to be applied. Otherwise you will see the following notice: "tor:
119+
Authentication cookie /run/tor/control.authcookie could not be opened (check permissions)"
120+
on debug.log.
118121

119122
An alternative authentication method is the use
120123
of the `-torpassword=password` option. The `password` is the clear text form that

0 commit comments

Comments
 (0)