Browse code

MacOSX instructions for Homebrew (#7989)

Moritz Bartl authored on 19/01/2013 12:34:23
Showing 2 changed files
... ...
@@ -10,69 +10,51 @@
10 10
     <a href="<page docs/tor-doc-osx>">Mac OS X Client</a>
11 11
   </div> 
12 12
   <div id="maincol">
13
-    <h1>Running the Tor client on Mac OS X</h1>
13
+    <h1>Running Tor on Mac OS X</h1>
14 14
     <br>
15 15
     
16
-    <h2>Note that these are the installation instructions for running
17
-    a Tor client. The easiest way to do this is to simply download the
16
+    <h2>These are advanced installation instructions for running
17
+    Tor in a command line. The recommended way to use Tor is to simply download the
18 18
     <a href="<page projects/torbrowser>">Tor Browser Bundle</a> and you
19 19
     are done.
20 20
     </h2>
21 21
     
22
+    <p>Even though the Tor Browser Bundle comes with a regular Tor, and you could use the graphical interface to configure Tor as a relay and bridge easily, it will only run as long as you keep the Tor Browser open. The following instructions will set up Tor without graphical interface or a browser. Many people prefer this over TBB when they host hidden services or relay traffic for other Tor users. 
22 23
     <hr>
23 24
     <a id="installing"></a>
24
-    <h2><a class="anchor" href="#installing">Step One: Download and Install Tor</a></h2>
25
+    <h2><a class="anchor" href="#installing">Step One: Install Homebrew</a></h2>
25 26
     <br>
26 27
     
27 28
     <p>
28
-    The install for Macintosh OS X bundles <a href="<page index>">Tor</a>,
29
-    <a href="<page projects/vidalia>">Vidalia</a> (a graphical interface
30
-    for Tor), <a href="<page torbutton/index>">Torbutton</a>, into one
31
-    package, with the three applications pre-configured to work together.
32
-    Download either the <a href="<page download/download>#mac">stable</a>
33
-    or the <a href="<page download/download>#mac">experimental</a>
34
-    version of the OS X bundle, or look for more options on the <a
35
-    href="<page download/download>">download page</a>.
29
+    The advanced Tor without any graphical user interface can be installed using <a href="http://mxcl.github.com/homebrew">the Homebrew package manager</a>. It is most suitable if you want to use Tor as a SOCKS proxy for applications other than web browsing, or run a Tor relay/bridge to help other Tor users. If you use the command-line Tor, you might be interested in <a href="<page projects/arm">ARM</a>, a command-line Tor monitor and alternative to the Vidalia GUI.. 
36 30
     </p>
37 31
     
38
-    <p>Once you've downloaded the dmg, double-click and let it mount.
39
-    Browse to the now open Vidalia Bundle in Finder.  It's easy to
40
-    install the bundle; simply drag and drop the Vidalia onion icon to the
41
-    Applications folder.  Optionally, double click the "install torbutton"
42
-    script and let it install torbutton into Firefox.</p>
43
-    
44
-    <p>When you are finished installing, you can start Vidalia by
45
-    selecting its icon from your Applications folder. A dark onion with a
46
-    red X in your dock means Tor is not currently running. You can start
47
-    Tor by selecting Start from the "Tor" menu at the top of your screen.
48
-    </p>
49
-    
50
-    <p>When Tor is running, Vidalia's dock icon will look like the following:
51
-    </p>
52
-    
53
-    <p><img alt="vidalia running tor"
54
-    src="$(IMGROOT)/screenshot-osx-vidalia.png" /></p>
32
+    <p>If you don't have Homebrew installed, open a terminal window and run:</p>
33
+ 
34
+    <pre>ruby -e "$(curl -fsSkL raw.github.com/mxcl/homebrew/go)"</pre>
55 35
     
56 36
     <hr>
57
-    <a id="using"></a>
58
-    <h2><a class="anchor" href="#using">Step Two: Configure your applications to use Tor</a></h2>
37
+    <h2>Step Two: Install Tor</a></h2>
59 38
     <br>
60 39
     
61
-    <p>After installing, you need to configure your applications to use
62
-    them. The first step is to set up web browsing.</p>
63
-    
64
-    <p>You should use Tor with Firefox and Torbutton, for best safety.
65
-    Torbutton was installed for you.  Click on the red "Tor Disabled"
66
-    toggle button to turn Tor on, and you're all set: </p>
67
-    
68
-    <p><img alt="Torbutton plugin for Firefox"
69
-    src="$(IMGROOT)/screenshot-torbutton.png" /></p>
70
-    
71
-    <p> If you plan to run Firefox on a different computer than Tor,
72
-    see the <a href="<wikifaq>#SocksListenAddress">FAQ entry for running
73
-    Tor on a different computer</a>.  </p>
40
+    <p>In a terminal window, run:</p>
41
+
42
+    <pre>brew install tor</pre>
43
+ 
44
+    <p>You will find the Tor configuration file at <tt>/usr/local/etc/tor/torrc</tt>.</p>
45
+ 
46
+    <hr>
47
+    <a id="verify"></a>
48
+    <h2><a class="anchor" href="#verify">Step Three: Verify your download</a></h2>
49
+  
50
+    <p>As with any application, you should make sure it came unmodified from the orginal source. Unfortunately, Homebrew does not come with integrated verification for downloads, and anyone could submit a modified Tor! Currently, we don't have good instructions on how to verify the Tor download on Mac OSX. If you think you do, please <a href="<page about/contact>">let us know</a>!</p>
51
+
52
+    <hr>
53
+    <a id="using"></a> 
54
+    <h2><a class="anchor" href="#using">Step Four: Configure your application to use Tor</a></h2>
74 55
     
75
-    <p>To use SOCKS directly (for instant messaging, Jabber, IRC, etc),
56
+    <p>
57
+    If you want to use Tor for anonymous web browsing, please use the <a href="<page projects/torbrowser>">Tor Browser Bundle</a>. It comes with readily configured Tor and a browser patched for better anonymity. To use SOCKS directly (for instant messaging, Jabber, IRC, etc),
76 58
     you can point your application directly at Tor (localhost
77 59
     port 9050), but see <a href="<wikifaq>#SOCKSAndDNS">this FAQ
78 60
     entry</a> for why this may be dangerous. For applications
... ...
@@ -83,20 +65,6 @@
83 65
     <a href="<wiki>doc/TorifyHOWTO">Torify HOWTO</a>.
84 66
     </p>
85 67
     
86
-    <hr>
87
-    <a id="verify"></a>
88
-    <h2><a class="anchor" href="#verify">Step Three: Make sure it's working</a></h2>
89
-    <br>
90
-    
91
-    <p>
92
-    Next, you should try using your browser with Tor and make
93
-    sure that your IP address is being anonymized. Click on <a
94
-    href="https://check.torproject.org/">the Tor detector</a> and see
95
-    whether it thinks you're using Tor or not.  (If that site is down,
96
-    see <a href="<wikifaq>#IsMyConnectionPrivate">this FAQ entry</a>
97
-    for more suggestions on how to test your Tor.)
98
-    </p>
99
-    
100 68
     <p>If you have a personal firewall that limits your computer's
101 69
     ability to connect to itself, be sure to allow connections from
102 70
     your local applications to local port 9050. If your
... ...
@@ -116,7 +84,7 @@
116 84
     <hr>
117 85
     <a id="server"></a>
118 86
     <a id="relay"></a>
119
-    <h2><a class="anchor" href="#relay">Step Four: Configure it as a relay</a></h2>
87
+    <h2><a class="anchor" href="#relay">Configure Tor as a relay</a></h2>
120 88
     <br>
121 89
     
122 90
     <p>The Tor network relies on volunteers to donate bandwidth. The more
... ...
@@ -138,13 +106,9 @@
138 106
     
139 107
     <hr>
140 108
     <a id="uninstall"></a>
141
-    <h2><a class="anchor" href="#uninstall">How To Uninstall Tor and Polipo</a></h2>
109
+    <h2><a class="anchor" href="#uninstall">How To Uninstall Tor</a></h2>
142 110
     <br>
143
-    
144
-    <p>There are two ways to uninstall the bundle from your computer,
145
-    using Finder or a command line or Terminal-based uninstaller.
146
-    If you want to remove Tor on OSX, here's how:</p>
147
-    
111
+
148 112
     <p>Change your application proxy settings back to their original
149 113
     values.  If you just want to stop using Tor, you can end at this
150 114
     point.</p>
... ...
@@ -154,22 +118,13 @@
154 118
     
155 119
     <ol>
156 120
     <li>Open Finder and click on Applications.</li>
157
-    <li>Drag /Applications/Vidalia to the Trash.</li>
121
+    <li>Drag /Applications/TorBrowser to the Trash.</li>
158 122
     <li>Remove /Library/Torbutton from your system.</li>
159 123
     <li>In your User or home directory, go to Library, remove the Vidalia
160 124
     directory</li>
161 125
     </ol>
162 126
     
163
-    <p>Tor and Vidalia are now completely removed from your system.</p>
164
-    
165
-    <p>If you're familiar with the command line or Terminal, you can
166
-    manually type the following:</p>
167
-    <ul>
168
-    <li>rm -r /Applications/Vidalia.app</li>
169
-    <li>rm -r /Library/Torbutton</li>
170
-    <li>rm -r ~/Library/Vidalia</li>
171
-    <li>rm -r ~/.tor</li>
172
-    </ul>
127
+    <p>Tor Browser is now completely removed from your system.</p>
173 128
     
174 129
     <hr>
175 130
     
176 131
deleted file mode 100644
177 132
Binary files a/images/screenshot-osx-vidalia.png and /dev/null differ