[tahoe-lafs-trac-stream] [Tahoe-LAFS] #2815: document manual server-on-.onion Tor setup process

[Tahoe-LAFS]

#2815: document manual server-on-.onion Tor setup process
---------------------------+------------------------
 Reporter:  warner         |          Owner:
     Type:  task           |         Status:  new
 Priority:  normal         |      Milestone:  1.12.0
Component:  code-network   |        Version:  1.11.0
 Keywords:  anonymity tor  |  Launchpad Bug:
---------------------------+------------------------
 Now that #2788 has landed, one remaining task for #517 (Tor support) is to
 explain how to setup Tor-only servers. The process is:

 * choose LOCAL port, choose TORPORT numbers
 * configure Tor to point an onion address (+TORPORT) at localhost:LOCAL
 * restart Tor, learn the ONION address
 * edit `tahoe.cfg` to set `tub.port` to `tcp:LOCAL:interface=127.0.0.1`
 * set `tub.location` to `tor:ONION.onion:TORPORT`
 * maybe set `anonymous=true` (#1010)

 We should also include some docs on how to test that it's working. The
 welcome page shows what IP address is used for current connections: it
 should be localhost (for outbound SOCKS connections, or inbound
 connections from the Tor daemon that originated as .onion connections).

 It should also have some pointers on how to install the necessary
 libraries: `pip install tahoe-lafs[tor]`, and `apt-get install tor`, or
 running the Tor Browser Bundle.

--
Ticket URL: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/2815>
Tahoe-LAFS <https://Tahoe-LAFS.org>
secure decentralized storage