Browse code

import and rewrite the #torrc faq entry

Roger Dingledine authored on 07/02/2011 08:59:35
Showing 1 changed files
... ...
@@ -45,6 +45,10 @@
45 45
     </ul>
46 46
 
47 47
     <p>Running Tor:</p>
48
+    <ul>
49
+    <li><a href="#torrc">I'm supposed to "edit my torrc". What does
50
+    that mean?</a></li>
51
+    </ul>
48 52
 
49 53
     <p>Running a Tor client:</p>
50 54
     <ul>
... ...
@@ -88,7 +92,7 @@
88 92
     relay.</a></li>
89 93
     </ul>
90 94
 
91
-    <p>Abuse</p>
95
+    <p>Abuse:</p>
92 96
     <ul>
93 97
     <li><a href="#Criminals">Doesn't Tor enable criminals to do bad things?</a></li>
94 98
     <li><a href="#RespondISP">How do I respond to my ISP about my exit
... ...
@@ -748,6 +752,66 @@ encryption, what data you're sending to the destination.</dd>
748 752
 
749 753
 <hr>
750 754
 
755
+<a id="torrc"></a>
756
+<h3><a class="anchor" href="#torrc">I'm supposed to "edit my torrc". What
757
+does that mean?</a></h3>
758
+
759
+<p>
760
+Tor installs a text file called torrc that contains configuration
761
+instructions for how your Tor program should behave. The default
762
+configuration should work fine for most Tor users. Users of Vidalia can
763
+make common changes through the Vidalia interface &mdash; only advanced
764
+users should need to modify their torrc file directly.
765
+</p>
766
+
767
+<p>
768
+The location of your torrc file depends on the way you installed Tor:
769
+</p>
770
+
771
+<ul>
772
+<li>On Windows, if you installed a Tor bundle with Vidalia, you can
773
+find your torrc file in the Start menu under Programs -&gt; Vidalia
774
+Bundle -&gt; Tor, or you can find it by hand in <code>\Documents and
775
+Settings\<i>username</i>\Application Data\Vidalia\torrc</code>. If you
776
+installed Tor without Vidalia, you can find your torrc in the Start
777
+menu under Programs -&gt; Tor, or manually in either <code>\Documents
778
+and Settings\Application Data\tor\torrc</code> or <code>\Documents and
779
+Settings\<i>username</i>\Application Data\tor\torrc</code>.
780
+</li>
781
+<li>On OS X, if you use Vidalia, edit
782
+<code>~/.vidalia/torrc</code>. Otherwise, open your favorite text editor
783
+and load <code>/Library/Tor/torrc</code>.
784
+</li>
785
+<li>On Unix, if you installed a pre-built package, look for
786
+<code>/etc/tor/torrc</code> or <code>/etc/torrc</code> or consult your
787
+package's documentation.
788
+</li>
789
+<li>Finally, if you installed from source, you may not have a torrc
790
+installed yet: look in <code>/usr/local/etc/</code> and note that you
791
+may need to manually copy <code>torrc.sample</code> to <code>torrc</code>.
792
+</li>
793
+</ul>
794
+
795
+<p>
796
+If you use Vidalia, be sure to exit both Tor and Vidalia before you edit
797
+your torrc file. Otherwise Vidalia might overwrite your changes.
798
+</p>
799
+
800
+<p>
801
+Once you've changed your torrc, you will need to restart Tor for the
802
+changes to take effect. (For advanced users on OS X and Unix, note that
803
+you actually only need to send Tor a HUP signal, not actually restart it.)
804
+</p>
805
+
806
+<p>
807
+For other configuration options you can use, look at the <a href="<page
808
+docs/tor-manual>">Tor manual page</a>. Remember, all lines beginning
809
+with # in torrc are treated as comments and have no effect on Tor's
810
+configuration.
811
+</p>
812
+
813
+<hr>
814
+
751 815
 <a id="DoesntWork"></a>
752 816
 <h3><a class="anchor" href="#DoesntWork">I installed Tor and Polipo but
753 817
 it's not working.</a></h3>