[tor-bugs] #6446 [TorBirdy]: create end user documentation / document setup/requirements

[Tor Bug Tracker & Wiki]

#6446: create end user documentation / document setup/requirements
-------------------------+--------------------------------------------------
 Reporter:  tagnaq       |          Owner:  tagnaq
     Type:  enhancement  |         Status:  new   
 Priority:  normal       |      Milestone:        
Component:  TorBirdy     |        Version:        
 Keywords:               |         Parent:        
   Points:               |   Actualpoints:        
-------------------------+--------------------------------------------------

Comment(by tagnaq):

 more instances on docu req:
 https://lists.torproject.org/pipermail/tor-talk/2012-August/025406.html
 https://lists.torproject.org/pipermail/tor-talk/2012-August/025411.html

 {{{
 Short TorBirdy Installation Guide

 This short guide should help you to setup your Thunderbird email client to
 send and fetch email via Tor.
 It can be used for new or already existing email accounts. Bear in mind
 that email accounts
 that have been used without Tor before offer less privacy/anonymity/weaker
 pseudonyms than email account that have been
 created using TorBrowser and have never been accessed without Tor, but
 TorBirdy is still useful for exiting accounts or real name email addresses
 especially if you are looking for location anonymity, i.e. you travel a
 lot and don't want to disclose all your locations by sending emails.
 TorBirdy works with SMTP and IMAP/POP3 but POP3 is recommended over IMAP.


 Required Software

 - Tor (e.g. via "Vidalia Bundle" or "Expert Bundle" )
 - Thunderbird
 - TorBirdy Addon

 TorBirdy does not require a running instance of the TorBrowser Bundle
 (TBB) and with default config does not conflict with that instance because
 TBB chooses random ports for SocksPort and ControlPort.

 recommended (optional):
 We recommend the use of end-to-end encrypted email using OpenPGP/Enigmail.
 The configuration of GPG and Enigmail is beyond the scope of this short
 user guide for TorBirdy.

 Setup Steps

 1.
 a) Windows/OSX: Download [1] and install the Vidalia Bundle and make sure
 Tor is running and listening on 127.0.0.1 on port 9050 (default config)
 b) GNU/Linux: install Tor with your system package management system and
 make sure Tor is running on port 9050 (default config)

 2. Open Thunderbird's Add-ons configuraton (Tools -> Add-ons) and type
 "torbirdy" into the search box on the right hand side
 3. then click "Install"

 Verify Setup

 After everything is setup try to send yourself an email and fetch it
 afterwards.


 [1] https://www.torproject.org/download/download.html.en
 [2] https://www.mozilla.org/thunderbird/
 [3] https://addons.mozilla.org/en-us/thunderbird/addon/torbirdy/
 [4] https://addons.mozilla.org/en-us/thunderbird/addon/enigmail/
 ------

 Troubleshooting
 If things don't work for you:

 1. make sure Tor is running and listening on 127.0.0.1 (localhost) on port
 9050
 2. inspect Vidalia while sending/fetching emails and confirm that
 something is trying to use the Tor instance to connect to an POP3/IMAP
 port.
 }}}

 TODO:
 - automatic+reoccurring email fetching
 - HTTP proxy
 - how to permanently run a tor instance on Windows/OSX (tor daemon
 instance for TorBirdy)

-- 
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/6446#comment:1>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online