tor-webwml.git

docs/en/tor-doc-server.wml   1) ## translation metadata
docs/en/tor-doc-server.wml   2) # Revision: $Revision$

docs/en/tor-doc-relay.wml    3) # Translation-Priority: 2-medium

docs/en/tor-doc-server.wml   4) 

docs/en/tor-doc-relay.wml    5) #include "head.wmi" TITLE="Tor: Relay Configuration Instructions"

docs/en/tor-doc-server.wml   6) 
docs/en/tor-doc-server.wml   7) <div class="center">
docs/en/tor-doc-server.wml   8) 
docs/en/tor-doc-server.wml   9) <div class="main-column">
docs/en/tor-doc-server.wml  10) 

docs/en/tor-doc-relay.wml   11) <h1>Configuring a Tor relay</h1>
docs/en/tor-doc-relay.wml   12) 
docs/en/tor-doc-relay.wml   13) <!-- BEGIN SIDEBAR -->
docs/en/tor-doc-relay.wml   14) <div class="sidebar-left">
docs/en/tor-doc-relay.wml   15) <h3>Config Steps</h3>
docs/en/tor-doc-relay.wml   16) <ol>

docs/en/tor-doc-relay.wml   17) <li><a href="<page docs/tor-doc-relay>#install">Download &amp; Install</a></li>

docs/en/tor-doc-relay.wml   18) <li><a href="<page docs/tor-doc-relay>#setup">Configuration</a></li>

docs/en/tor-doc-relay.wml   19) <li><a href="<page docs/tor-doc-relay>#check">Check &amp; Confirm</a></li>

docs/en/tor-doc-relay.wml   20) <li><a href="<page docs/tor-doc-relay>#after">Final Steps</a></li>
docs/en/tor-doc-relay.wml   21) </ol>
docs/en/tor-doc-relay.wml   22) </div>
docs/en/tor-doc-relay.wml   23) <!-- END SIDEBAR -->
docs/en/tor-doc-relay.wml   24) 
docs/en/tor-doc-relay.wml   25) <hr />

docs/en/tor-doc-server.wml  26) 
docs/en/tor-doc-server.wml  27) <p>
docs/en/tor-doc-server.wml  28) The Tor network relies on volunteers to donate bandwidth. The more

docs/en/tor-doc-relay.wml   29) people who run relays, the faster the Tor network will be. If you have

docs/en/tor-doc-server.wml  30) at least 20 kilobytes/s each way, please help out Tor by configuring your

docs/en/tor-doc-relay.wml   31) Tor to be a relay too. We have many features that make Tor relays easy

docs/en/tor-doc-relay.wml   32) and convenient, including <a href="<page faq>#RelayFlexible">rate limiting
docs/en/tor-doc-relay.wml   33) for bandwidth, exit policies so you can limit your exposure to abuse
docs/en/tor-doc-relay.wml   34) complaints, and support for dynamic IP addresses</a>.
docs/en/tor-doc-relay.wml   35) </p>

docs/en/tor-doc-server.wml  36) 

docs/en/tor-doc-relay.wml   37) <p>Having relays in many different places on the Internet is what

docs/en/tor-doc-server.wml  38) makes Tor users secure. <a

docs/en/tor-doc-relay.wml   39) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#RelayAnonymity">You

docs/en/tor-doc-server.wml  40) may also get stronger anonymity yourself</a>,
docs/en/tor-doc-server.wml  41) since remote sites can't know whether connections originated at your
docs/en/tor-doc-server.wml  42) computer or were relayed from others.</p>
docs/en/tor-doc-server.wml  43) 
docs/en/tor-doc-server.wml  44) 

docs/en/tor-doc-relay.wml   45) <p>You can run a Tor relay on

docs/en/tor-doc-server.wml  46) pretty much any operating system, but see <a

docs/en/tor-doc-relay.wml   47) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#RelayOS">this

docs/en/tor-doc-server.wml  48) FAQ entry</a> for advice about which ones work best and other problems
docs/en/tor-doc-server.wml  49) you might encounter.</p>
docs/en/tor-doc-server.wml  50) 
docs/en/tor-doc-server.wml  51) <hr />

docs/en/tor-doc-relay.wml   52) <a id="zero"></a>

docs/en/tor-doc-relay.wml   53) <a id="install"></a>
docs/en/tor-doc-relay.wml   54) <h2><a class="anchor" href="#install">Step One: Download and Install Tor</a></h2>

docs/en/tor-doc-server.wml  55) <br />
docs/en/tor-doc-server.wml  56) 
docs/en/tor-doc-server.wml  57) <p>Before you start, you need to make sure that Tor is up and running.
docs/en/tor-doc-server.wml  58) </p>
docs/en/tor-doc-server.wml  59) 
docs/en/tor-doc-server.wml  60) <p>For Windows users, this means at least <a

docs/en/tor-doc-relay.wml   61) href="<page docs/tor-doc-windows>#installing">step one</a>

docs/en/tor-doc-server.wml  62) of the Windows Tor installation howto. Mac OS X users need to do at least

docs/en/tor-doc-server.wml  63) <a href="<page docs/tor-doc-osx>#installing">step one</a>

docs/en/tor-doc-server.wml  64) of OS X Tor installation howto.  Linux/BSD/Unix users should do at least

docs/en/tor-doc-server.wml  65) <a href="<page docs/tor-doc-unix>#installing">step one</a>

docs/en/tor-doc-server.wml  66) of the Unix Tor installation howto.
docs/en/tor-doc-server.wml  67) </p>
docs/en/tor-doc-server.wml  68) <p>If it's convenient, you might also want to use it as a client for a
docs/en/tor-doc-server.wml  69) while to make sure it's actually working.</p>
docs/en/tor-doc-server.wml  70) 
docs/en/tor-doc-server.wml  71) <hr />

docs/en/tor-doc-server.wml  72) <a id="setup"></a>

docs/en/tor-doc-relay.wml   73) <h2><a class="anchor" href="#setup">Step Two: Set it up as a relay</a></h2>

docs/en/tor-doc-server.wml  74) <br />

docs/en/tor-doc-relay.wml   75) <ol>

docs/en/tor-doc-relay.wml   76) <li>Verify that your clock and timezone are set
docs/en/tor-doc-relay.wml   77) correctly. If possible, synchronize your clock with public <a
docs/en/tor-doc-relay.wml   78) href="http://en.wikipedia.org/wiki/Network_Time_Protocol">time
docs/en/tor-doc-relay.wml   79) servers</a>.

docs/en/tor-doc-relay.wml   80) </li>

docs/en/tor-doc-server.wml  81) 

docs/en/tor-doc-relay.wml   82) <li> <strong>Windows / OS X Configuration</strong>:

docs/en/tor-doc-relay.wml   83) <ol>

docs/en/tor-doc-relay.wml   84) <li>Right click on the Vidalia icon in your task bar.  Choose <tt>Control Panel</tt>.</li>
docs/en/tor-doc-relay.wml   85) <li>Click <tt>Setup Relaying</tt>.</li>

docs/en/tor-doc-relay.wml   86) <li>Choose <tt>Relay Traffic for the Tor network</tt> if you want to be
docs/en/tor-doc-relay.wml   87) a public relay (recommended), or choose <tt>Help censored users reach the
docs/en/tor-doc-relay.wml   88) Tor network</tt> if you want to be a <a href="<page bridges>">bridge</a>
docs/en/tor-doc-relay.wml   89) for users in countries that censor their Internet.</li>

docs/en/tor-doc-relay.wml   90) <li>Enter a nickname for your relay. (Optional, enter contact information.)</li>

docs/en/tor-doc-relay.wml   91) <li>Leave <tt>Attempt to automatically configure port forwarding</tt> clicked.

docs/en/tor-doc-relay.wml   92) Push the <tt>Test</tt> button to see if it works.  If it does work, great.

docs/en/tor-doc-relay.wml   93) If not, see number 4 below.</li>

docs/en/tor-doc-relay.wml   94) <li>Choose the <tt>Bandwidth Limits</tt> tab.  Select how much bandwidth you want to provide for Tor users like yourself.</li>
docs/en/tor-doc-relay.wml   95) <li>Choose the <tt>Exit Policies</tt> tab.  If you want to allow others
docs/en/tor-doc-relay.wml   96) to use your relay for these services, don't change anything.  Un-check

docs/en/tor-doc-relay.wml   97) the services you don't want to allow people to <a href="<page
docs/en/tor-doc-relay.wml   98) faq>#RunARelayBut">reach from your relay</a>.
docs/en/tor-doc-relay.wml   99) If you want to be a non-exit relay, un-check all services.</li>

docs/en/tor-doc-relay.wml  100) <li>Click the <tt>Ok</tt> button.  See Step Three below for confirmation

docs/en/tor-doc-relay.wml  101) that the relay is working correctly.</li>

docs/en/tor-doc-relay.wml  102) </ol>

docs/en/tor-doc-server.wml 103) 

docs/en/tor-doc-relay.wml  104) <br />

docs/en/tor-doc-relay.wml  105) <strong>Linux / BSD Configuration</strong>:

docs/en/tor-doc-relay.wml  106) <ul>

docs/en/tor-doc-relay.wml  107) <li>Edit the bottom part of <a
docs/en/tor-doc-relay.wml  108) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#torrc">your
docs/en/tor-doc-relay.wml  109) torrc file</a>. Make sure to define ORPort and <a href="<page
docs/en/tor-doc-relay.wml  110) faq>#RunARelayBut">look at ExitPolicy</a>
docs/en/tor-doc-relay.wml  111) if you want to be a public relay (recommended), or just add
docs/en/tor-doc-relay.wml  112) <a href="<page bridges>#RunningABridge">these lines</a>
docs/en/tor-doc-relay.wml  113) if you want to be a <a href="<page bridges>">bridge</a>
docs/en/tor-doc-relay.wml  114) for users in countries that censor their Internet.
docs/en/tor-doc-relay.wml  115) <!-- If you installed from source, create the DataDirectory if necessary
docs/en/tor-doc-relay.wml  116) and make sure it's owned by the user that will be running tor. -->
docs/en/tor-doc-relay.wml  117) </li>

docs/en/tor-doc-server.wml 118) 

docs/en/tor-doc-relay.wml  119) </ul></li>

docs/en/tor-doc-relay.wml  120) 
docs/en/tor-doc-relay.wml  121) <li> If you are using a firewall, open a hole in your firewall so

docs/en/tor-doc-relay.wml  122) incoming connections can reach the ports you configured (ORPort, plus

docs/en/tor-doc-server.wml 123) DirPort if you enabled it). Make sure you allow all outgoing connections,

docs/en/tor-doc-relay.wml  124) so your relay can reach the other Tor relays.

docs/en/tor-doc-relay.wml  125) </li>

docs/en/tor-doc-server.wml 126) 

docs/en/tor-doc-relay.wml  127) <li>Restart your relay. If it <a

docs/en/tor-doc-relay.wml  128) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#Logs">logs

docs/en/tor-doc-server.wml 129) any warnings</a>, address them.

docs/en/tor-doc-relay.wml  130) </li>

docs/en/tor-doc-server.wml 131) 

docs/en/tor-doc-relay.wml  132) <li>Subscribe to the <a

docs/en/tor-doc-server.wml 133) href="http://archives.seul.org/or/announce/">or-announce</a>
docs/en/tor-doc-server.wml 134) mailing list. It is very low volume, and it will keep you informed
docs/en/tor-doc-server.wml 135) of new stable releases. You might also consider subscribing to <a
docs/en/tor-doc-server.wml 136) href="http://archives.seul.org/or/talk/">or-talk</a> (higher volume),
docs/en/tor-doc-server.wml 137) where new development releases are announced.

docs/en/tor-doc-relay.wml  138) </li>

docs/en/tor-doc-server.wml 139) 

docs/en/tor-doc-relay.wml  140) <li>
docs/en/tor-doc-relay.wml  141) Have a look at the manual.

docs/en/tor-doc-server.wml 142) The <a href="<page tor-manual>">manual</a> for the

docs/en/tor-doc-server.wml 143) latest stable version provides a list of all the possible configuration

docs/en/tor-doc-relay.wml  144) options for both clients and relays.

docs/en/tor-doc-server.wml 145) If you are running the development version of Tor, the manual is available

docs/en/tor-doc-server.wml 146) <a href="<page tor-manual-dev>">here</a>.

docs/en/tor-doc-relay.wml  147) </li>
docs/en/tor-doc-relay.wml  148) </ol>

docs/en/tor-doc-server.wml 149) 
docs/en/tor-doc-server.wml 150) <hr />

docs/en/tor-doc-server.wml 151) <a id="check"></a>

docs/en/tor-doc-relay.wml  152) <h2><a class="anchor" href="#check">Step Three: Make sure it is working</a></h2>

docs/en/tor-doc-server.wml 153) <br />
docs/en/tor-doc-server.wml 154) 

docs/en/tor-doc-relay.wml  155) <p>As soon as your relay manages to connect to the network, it will

docs/en/tor-doc-server.wml 156) try to determine whether the ports you configured are reachable from

docs/en/tor-doc-server.wml 157) the outside. This may take up to 20 minutes. Look for a

docs/en/tor-doc-relay.wml  158) <a href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#Logs">log

docs/en/tor-doc-server.wml 159) entry</a> like

docs/en/tor-doc-server.wml 160) <tt>Self-testing indicates your ORPort is reachable from the outside. Excellent.</tt>

docs/en/tor-doc-relay.wml  161) If you don't see this message, it means that your relay is not reachable

docs/en/tor-doc-server.wml 162) from the outside — you should re-check your firewalls, check that it's
docs/en/tor-doc-server.wml 163) testing the IP and port you think it should be testing, etc.
docs/en/tor-doc-server.wml 164) </p>
docs/en/tor-doc-server.wml 165) 
docs/en/tor-doc-server.wml 166) <p>When it decides that it's reachable, it will upload a "server
docs/en/tor-doc-server.wml 167) descriptor" to the directories. This will let clients know

docs/en/tor-doc-relay.wml  168) what address, ports, keys, etc your relay is using. You can <a

docs/en/tor-doc-server.wml 169) href="http://moria.seul.org:9032/tor/status/authority">load one of
docs/en/tor-doc-server.wml 170) the network statuses manually</a> and

docs/en/tor-doc-server.wml 171) look through it to find the nickname you configured, to make sure it's
docs/en/tor-doc-server.wml 172) there. You may need to wait a few seconds to give enough time for it to
docs/en/tor-doc-server.wml 173) make a fresh directory.</p>
docs/en/tor-doc-server.wml 174) 
docs/en/tor-doc-server.wml 175) <hr />

docs/en/tor-doc-server.wml 176) <a id="after"></a>

docs/en/tor-doc-relay.wml  177) <h2><a class="anchor" href="#after">Step Four: Once it is working</a></h2>

docs/en/tor-doc-server.wml 178) <br />
docs/en/tor-doc-server.wml 179) 
docs/en/tor-doc-server.wml 180) <p>

docs/en/tor-doc-server.wml 181) We recommend the following steps as well:

docs/en/tor-doc-server.wml 182) </p>
docs/en/tor-doc-server.wml 183) 
docs/en/tor-doc-server.wml 184) <p>

docs/en/tor-doc-server.wml 185) 8. Read

docs/en/tor-doc-relay.wml  186) <a href="https://wiki.torproject.org/noreply/TheOnionRouter/OperationalSecurity">this document</a>

docs/en/tor-doc-relay.wml  187) to get ideas how you can increase the security of your relay.

docs/en/tor-doc-server.wml 188) </p>
docs/en/tor-doc-server.wml 189) 
docs/en/tor-doc-server.wml 190) <p>

docs/en/tor-doc-relay.wml  191) 9. If you want to run more than one relay that's great, but please set <a
docs/en/tor-doc-relay.wml  192) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#MultipleRelays">the
docs/en/tor-doc-relay.wml  193) MyFamily option</a> in all your relays' configuration files.

docs/en/tor-doc-server.wml 194) </p>
docs/en/tor-doc-server.wml 195) 
docs/en/tor-doc-server.wml 196) <p>

docs/en/tor-doc-server.wml 197) 10. Decide about rate limiting. Cable modem, DSL, and other users

docs/en/tor-doc-server.wml 198) who have asymmetric bandwidth (e.g. more down than up) should
docs/en/tor-doc-server.wml 199) rate limit to their slower bandwidth, to avoid congestion. See the <a

docs/en/tor-doc-relay.wml  200) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#LimitBandwidth">rate

docs/en/tor-doc-server.wml 201) limiting FAQ entry</a> for details.
docs/en/tor-doc-server.wml 202) </p>
docs/en/tor-doc-server.wml 203) 
docs/en/tor-doc-server.wml 204) <p>

docs/en/tor-doc-relay.wml  205) 11. Back up your Tor relay's private key (stored in "keys/secret_id_key"
docs/en/tor-doc-relay.wml  206) in your DataDirectory). This is your relay's "identity," and

docs/en/tor-doc-server.wml 207) you need to keep it safe so nobody can read the traffic that goes

docs/en/tor-doc-relay.wml  208) through your relay. This is the critical file to keep if you need to <a

docs/en/tor-doc-relay.wml  209) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#UpgradeRelay">move

docs/en/tor-doc-relay.wml  210) or restore your Tor relay</a> if something goes wrong.

docs/en/tor-doc-server.wml 211) </p>
docs/en/tor-doc-server.wml 212) 
docs/en/tor-doc-server.wml 213) <p>

docs/en/tor-doc-relay.wml  214) 
docs/en/tor-doc-relay.wml  215) 12. If you control the name servers for your domain, consider setting your
docs/en/tor-doc-relay.wml  216) reverse DNS hostname to 'anonymous-relay', 'proxy' or 'tor-proxy', so when
docs/en/tor-doc-relay.wml  217) other people see the address in their web logs, they will more quickly
docs/en/tor-doc-relay.wml  218) understand what's going on. Adding the <a
docs/en/tor-doc-relay.wml  219) href="https://tor-svn.freehaven.net/svn/tor/trunk/contrib/tor-exit-notice.html">Tor
docs/en/tor-doc-relay.wml  220) exit notice</a> on a vhost for this name can go a long way to deterring abuse
docs/en/tor-doc-relay.wml  221) complaints to you and your ISP if you are running an exit node.
docs/en/tor-doc-relay.wml  222) 

docs/en/tor-doc-server.wml 223) </p>
docs/en/tor-doc-server.wml 224) 
docs/en/tor-doc-server.wml 225) <p>

docs/en/tor-doc-server.wml 226) 13. If your computer isn't running a webserver, please consider

docs/en/tor-doc-server.wml 227) changing your ORPort to 443 and your DirPort to 80. Many Tor
docs/en/tor-doc-server.wml 228) users are stuck behind firewalls that only let them browse the

docs/en/tor-doc-relay.wml  229) web, and this change will let them reach your Tor relay. Win32
docs/en/tor-doc-relay.wml  230) relays can simply change their ORPort and DirPort directly
docs/en/tor-doc-relay.wml  231) in their torrc and restart Tor. OS X or Unix relays can't bind

docs/en/tor-doc-server.wml 232) directly to these ports (since they don't run as root), so they will
docs/en/tor-doc-server.wml 233) need to set up some sort of <a

docs/en/tor-doc-relay.wml  234) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#ServerForFirewalledClients">

docs/en/tor-doc-relay.wml  235) port forwarding</a> so connections can reach their Tor relay. If you are

docs/en/tor-doc-server.wml 236) using ports 80 and 443 already but still want to help out, other useful
docs/en/tor-doc-server.wml 237) ports are 22, 110, and 143.
docs/en/tor-doc-server.wml 238) </p>
docs/en/tor-doc-server.wml 239) 
docs/en/tor-doc-server.wml 240) <p>

docs/en/tor-doc-relay.wml  241) 14. If your Tor relay provides other services on the same IP address

docs/en/tor-doc-server.wml 242) — such as a public webserver — make sure that connections to the
docs/en/tor-doc-server.wml 243) webserver are allowed from the local host too. You need to allow these

docs/en/tor-doc-relay.wml  244) connections because Tor clients will detect that your Tor relay is the <a

docs/en/tor-doc-relay.wml  245) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ#ExitEavesdroppers">safest

docs/en/tor-doc-server.wml 246) way to reach that webserver</a>, and always build a circuit that ends

docs/en/tor-doc-relay.wml  247) at your relay. If you don't want to allow the connections, you must

docs/en/tor-doc-server.wml 248) explicitly reject them in your exit policy.
docs/en/tor-doc-server.wml 249) </p>
docs/en/tor-doc-server.wml 250) 
docs/en/tor-doc-server.wml 251) <p>

docs/en/tor-doc-relay.wml  252) 15. (Unix only). Make a separate user to run the relay. If you

docs/en/tor-doc-server.wml 253) installed the OS X package or the deb or the rpm, this is already

docs/en/tor-doc-relay.wml  254) done. Otherwise, you can do it by hand. (The Tor relay doesn't need to

docs/en/tor-doc-server.wml 255) be run as root, so it's good practice to not run it as root. Running
docs/en/tor-doc-server.wml 256) as a 'tor' user avoids issues with identd and other services that
docs/en/tor-doc-server.wml 257) detect user name. If you're the paranoid sort, feel free to <a

docs/en/tor-doc-relay.wml  258) href="https://wiki.torproject.org/noreply/TheOnionRouter/TorInChroot">put Tor

docs/en/tor-doc-server.wml 259) into a chroot jail</a>.)
docs/en/tor-doc-server.wml 260) </p>
docs/en/tor-doc-server.wml 261) 
docs/en/tor-doc-server.wml 262) <p>

docs/en/tor-doc-server.wml 263) 16. (Unix only.) Your operating system probably limits the number

docs/en/tor-doc-server.wml 264) of open file descriptors per process to 1024 (or even less). If you
docs/en/tor-doc-server.wml 265) plan to be running a fast exit node, this is probably not enough. On
docs/en/tor-doc-server.wml 266) Linux, you should add a line like "toruser hard nofile 8192" to your
docs/en/tor-doc-server.wml 267) /etc/security/limits.conf file (where toruser is the user that runs the
docs/en/tor-doc-server.wml 268) Tor process), and then restart Tor if it's installed as a package (or log

docs/en/tor-doc-relay.wml  269) out and log back in if you run it yourself).

docs/en/tor-doc-server.wml 270) </p>
docs/en/tor-doc-server.wml 271) 
docs/en/tor-doc-server.wml 272) <p>

docs/en/tor-doc-relay.wml  273) 17. If you installed Tor via some package or installer, it probably starts

docs/en/tor-doc-server.wml 274) Tor for you automatically on boot. But if you installed from source,
docs/en/tor-doc-server.wml 275) you may find the initscripts in contrib/tor.sh or contrib/torctl useful.
docs/en/tor-doc-server.wml 276) </p>
docs/en/tor-doc-server.wml 277) 

docs/en/tor-doc-server.wml 278) <p>

docs/en/tor-doc-server.wml 279) When you change your Tor configuration, remember to verify that your

docs/en/tor-doc-relay.wml  280) relay still works correctly after the change. Be sure to set your

docs/en/tor-doc-server.wml 281) "ContactInfo" line in the torrc so we can contact you if you need to
docs/en/tor-doc-server.wml 282) upgrade or something goes wrong. If you have problems or questions, see
docs/en/tor-doc-server.wml 283) the <a href="<page documentation>#Support">Support</a> section or
docs/en/tor-doc-server.wml 284) <a href="<page contact>">contact us</a> on the tor-ops list. Thanks
docs/en/tor-doc-server.wml 285) for helping to make the Tor network grow!

docs/en/tor-doc-server.wml 286) </p>
docs/en/tor-doc-server.wml 287) 

docs/en/tor-doc-server.wml 288) <hr />
docs/en/tor-doc-server.wml 289) 

docs/en/tor-doc-server.wml 290) <p>If you have suggestions for improving this document, please <a
docs/en/tor-doc-server.wml 291) href="<page contact>">send them to us</a>. Thanks!</p>