New upstream version
[tor.git] / INSTALL
blob20b077b466246f17cb8cabe90ede0720dd96fdf1
1 Quickstart version for users:
3 0) Download the absolute newest version. No, really.
4   http://freehaven.net/tor/dist/
5 1) tar xvf it, and then cd into the directory.
6 2) ./configure
7 3) make
8 4) make install (as root if necessary)
9 5) tor (if it doesn't work, give it the whole path or fix your path)
10   You don't need to run this as root, and you probably shouldn't.
11   (If you're having problems, try running it with "-l info" to get
12    more details.)
13 6) point your browser to socks4 or socks5 proxy at localhost port
14   9050. In mozilla, this is in edit|preferences|advanced|proxies. This
15   allows you to test to make sure tor is installed correctly.
16   (If you have a personal firewall, be sure to allow local connections
17    to port 9050.)
18   (If your firewall blocks outgoing connections, punch a hole so it
19    can connect to TCP *:9001-9004 and *:9031-9033)
20   (If you're using Safari as your browser, keep in mind that OS X before
21    10.3 claims to support socks but does not. You must do step 8.)
22 7) make sure you've set it up correctly: go to
23   http://www.junkbusters.com/cgi-bin/privacy and see what IP it says
24   you're coming from. If it works, you should probably go on to step 8,
25   to get better privacy.
27 8) Optionally, install privoxy (www.privoxy.org), and add the line
28   "forward-socks4a / localhost:9050 ." (without the quotes -- don't forget
29   the dot) to its config file. Then change your mozilla to http proxy
30   at localhost port 8118 (and no socks proxy). This step will give you
31   good html scrubbing as well.
32   (See doc/CLIENTS for why direct socks gives you less anonymity.)
34 *****If this works for you, you can stop reading here******
36 If you got the source from cvs:
38   Run "./autogen.sh", which will run the various auto* programs and then
39   run ./configure for you. From there, start at step 3 in the quickstart
40   list above.
42 If the quickstart doesn't work for you:
44   If you have problems finding libraries, try 
45     CPPFLAGS="-I/usr/local/include" LDFLAGS="-L/usr/local/lib" \
46     ./configure
47   rather than simply ./configure.
49   Check out the list archives at http://archives.seul.org/or/dev/ and see
50   if somebody else has reported your problem. If not, please subscribe
51   and let us know what you did to fix it, or give us the details and
52   we'll see what we can do.