commit ab62732b99db9efaa0ff8cb2d424317cf40df6c3 Author: juga0 juga@riseup.net Date: Tue Sep 18 17:53:58 2018 +0000

Add page about tor config, removed from specification --- docs/source/config_tor.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+)

diff --git a/docs/source/config_tor.rst b/docs/source/config_tor.rst new file mode 100644 index 0000000..1ddde81 --- /dev/null +++ b/docs/source/config_tor.rst @@ -0,0 +1,18 @@ +.. _config_tor: + +sbws scanner tor configuration +------------------------------- + +At the time of writing, sbws sets the following torrc options for the following +reasons when it launches Tor. You can find them in ``sbws/globals.py`` and +``sbws/util/stem.py``. + +- ``SocksPort auto``: To proxy requests over Tor. +- ``CookieAuthentication 1``: The easiest way to authenticate to Tor. +- ``LearnCircuitBuildTimeout 0``: To keep circuit build timeouts static. +- ``CircuitBuildTimeout 10``: To give up on struggling circuits sooner. +- ``UseEntryGuards 0``: To avoid path bias warnings. +- ``DataDirectory ...``: To set Tor's datadirectory to be inside sbws's. +- ``PidFile ...``: To make it easier to tell if Tor is running. +- ``ControlSocket ...``: To control Tor. +- ``Log notice ...``: To know what the heck is going on.