tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 2-medium
4) 
5) #include "head.wmi" TITLE="Tor Project: Relay Configuration Instructions" CHARSET="UTF-8"
6) <div id="content" class="clearfix">
7)   <div id="breadcrumbs">

8)     <a href="<page index>">Home &raquo; </a>

9)     <a href="<page docs/documentation>">Documentation &raquo; </a>
10)     <a href="<page docs/tor-doc-relay>">Configure Tor Relay</a>

11)   </div>
12)   <div id="maincol">

13) 
14)     <h1>Configuring a Tor relay</h1>

15) 

16)     <hr>

17) 

18)     <p>
19)     The Tor network relies on volunteers to donate bandwidth. The more
20)     people who run relays, the faster the Tor network will be. If you have

21)     at least 250 kilobytes/s each way, please help out Tor by configuring your

22)     Tor to be a relay too.

23)     </p>

24) 

25)     <p>You can run a Tor relay on pretty much any operating system. Tor relays
26)     work best on Linux, OS X Tiger or later, FreeBSD 5.x+, NetBSD 5.x+, and
27)     Windows Server 2003 or later.

28)     </p>

29) 

30)     <p>

31)     The best approach for most users is to <a href="<page
32)     docs/tor-relay-debian>">run your relay on Debian or Ubuntu</a> using

33)     the system Tor package — the deb takes care of running Tor as a

34)     separate user, making sure it has enough file descriptors available,
35)     starting it at boot, and so on. Tor relays also run nicely on other
36)     Linux flavors, and on FreeBSD and NetBSD for those who are comfortable
37)     with those operating systems.
38)     </p>

39) 

40)     <p>Windows users can use the Vidalia Bridge Bundle, the Vidalia Relay
41)     Bundle and the Vidalia Exit Bundle, which come preconfigured to run
42)     Tor as a bridge, a non-exit relay, or an exit relay. Get them from
43)     the <a href="<page download/download>">download page</a>, and use
44)     the graphical instructions below for help setting them up.

45)     </p>
46) 

47)     <p>Alas, since Vidalia (a graphical interface for Tor) is <a
48)     href="<page docs/faq>#WhereDidVidaliaGo">no longer included</a>
49)     in the standard Tor Browser Bundle, there are currently no
50)     easy relay packages for OS X users. One option is to run
51)     Debian in a VM; another option is to install TBB and then a
52)     standalone Vidalia bundle on top of it; and a third option is to <a
53)     href="https://lists.torproject.org/pipermail/tor-relays/2014-June/004650.html">use
54)     Homebrew</a>. Please help make this process easier!

55)     </p>
56) 

57)     <hr>
58)     <a id="setup"></a>
59)     <h2><a class="anchor" href="#setup">Configure Tor with the Vidalia Graphical Interface</a></h2>
60)     <br>
61) 
62)     <p>Please note that this graphical approach is only for
63)     Windows users (and very dedicated OS X users): most fast Tor
64)     relays are run on Debian or Ubuntu using the <a href="<page
65)     docs/tor-relay-debian>">system Tor package</a>, and we encourage
66)     you to go that route too.
67)     </p>
68) 

69)     <p>

70)     Before you start, verify that your clock and timezone are set

71)     correctly. If possible, synchronize your clock with public <a
72)     href="http://en.wikipedia.org/wiki/Network_Time_Protocol">time

73)     servers</a>.
74)     </p>

75) 
76)     <ol type=1>

77) 
78) 

79) <li>Right click on the Vidalia icon in your task bar.  Choose Control Panel.</li><br />
80)     	<img alt="Vidalia right click menu" src="$(IMGROOT)/screenshot-win32-vidalia.png" />

81) 

82)     <li>Click "Setup Relaying".</li>

83) 

84)     <li>

85)     Choose "Relay Traffic for the Tor network" if you
86) want to be a public relay (recommended), or choose "Help
87) censored users reach the Tor network" if you want to be a <a

88) href="<page docs/faq>#RelayOrBridge">non-public bridge</a>.</li><br />
89)     <img alt="Vidalia basic settings" src="$(IMGROOT)/screenshot-win32-configure-relay-1.png" />

90) 

91)     <li>Enter a nickname for your relay, and enter contact information in
92)     case we need to contact you about problems.</li>

93) 

94)     <li>Leave "Attempt to automatically configure port forwarding" ticked.
95)     Push the "Test" button to see if it works. If it does work, great.
96)     If not, see the section on reachability below.</li>

97) 

98)     <li>Choose the "Bandwidth Limits" tab.  Select how much bandwidth you want to provide for Tor users like yourself.</li><br />
99)     <img alt="Vidalia bandwidth limits" src="$(IMGROOT)/screenshot-win32-configure-relay-2.png" />

100) 

101)     <li>Select the "Exit Policies" tab.  If you want to allow others

102)     to use your relay for these services, don't change anything.  Un-check

103)     the services you don't want to allow people to <a href="<page
104)     docs/faq>#ExitPolicies">reach from your relay</a>.  If you want to

105)     be a non-exit relay, un-check all services.</li><br />
106)     <img alt="Vidalia exit policies" src="$(IMGROOT)/screenshot-win32-configure-relay-3.png" />

107) 

108)     <li>Click "Ok".</li>

109) 

110)     </ol>
111) 
112)     <hr>
113)     <a id="torrc"></a>

114)     <h2><a class="anchor" href="#torrc">Configure Tor by editing the torrc file</a></h2>

115)     <br />

116) 

117)     <p>

118)     You can set up a relay without using Vidalia if you wish. Tor's
119)     configuration file is named 'torrc'. In the Tor Browser folder, it's

120)     located at</p>
121)     <pre>Data\Tor\torrc</pre>
122)     <p>Open the file with a text editor and add the following lines:</p>

123) 
124)     <pre>
125)     ORPort 443
126)     Exitpolicy reject *:*

127)     Nickname ididntedittheconfig

128)     ContactInfo human@...
129)     </pre>
130) 

131)     <p>If you want to be a bridge, read about the BridgeRelay and
132)     ServerTransportPlugin values <a

133)     href="<page projects/obfsproxy-instructions>#instructions">on

134)     this page</a>.</p>
135) 

136)     <p>Tor will use all your bandwidth if you don't set limits for it. Some
137)     options are described in <a href="<page docs/faq>#LimitTotalBandwidth">these</a>

138)     <a href="<page docs/faq>#BandwidthShaping">FAQ entries</a>.</p>
139) 

140)     <p>See the <a href="https://gitweb.torproject.org/tor.git/blob_plain/HEAD:/src/config/torrc.sample.in">sample

141)     torrc file</a> and the <a

142)     href="<page docs/tor-manual>">man

143)     page</a> for other Tor options you may want to set.</p>

144) 

145)     <hr>

146)     <a id="check"></a>

147)     <h2><a class="anchor" href="#check">Make sure your relay is reachable</a></h2>

148)     <br>

149) 

150)     <p>If you are using a firewall, open a hole in your firewall
151)     so incoming connections can reach the ports you configured
152)     (ORPort, plus DirPort if you enabled it). If you have a
153)     hardware firewall (Linksys box, cable modem, etc) you might find <a
154)     href="http://portforward.com/">portforward.com</a> useful. Also, make sure you
155)     allow all <em>outgoing</em> connections too, so your relay can reach the
156)     other Tor relays.
157)     </p>
158) 
159)     <p>Restart your relay. If it <a
160)     href="<page docs/faq>#Logs">logs
161)     any warnings</a>, address them.
162)     </p>
163) 

164)     <p>As soon as your relay manages to connect to the network, it will
165)     try to determine whether the ports you configured are reachable from
166)     the outside. This step is usually fast, but may take up to 20

167)     minutes. Look for a <a href="<page docs/faq>#Logs">log entry</a> like

168)     <pre>Self-testing indicates your ORPort is reachable from the outside. Excellent.</pre>

169)     If you don't see this message, it means that your relay is not reachable
170)     from the outside — you should re-check your firewalls, check that it's
171)     testing the IP and port you think it should be testing, etc.
172)     </p>

173) 

174)     <p>When your relay has decided that it's reachable, it will upload a "server

175)     descriptor" to the directories, to let clients know

176)     what address, ports, keys, etc your relay is using. You can search <a

177)     href="https://atlas.torproject.org/">Atlas</a> or <a
178)     href="https://globe.torproject.org/">Globe</a> for
179)     the nickname you configured, to make sure it's there. You may need to wait

180)     up to one hour for the directories to publish the new server information.</p>

181) 

182)     <hr>

183)     <a id="after"></a>

184)     <h2><a class="anchor" href="#after">Once your relay is working</a></h2>

185)     <br>

186) 

187)     <p>To learn more about the proper care and feeding for your relay,
188)     see the advice on the <a href=<page docs/tor-relay-debian>#after>Tor
189)     relay on Debian/Ubuntu</a> page.

190)     </p>
191) 

192)     <hr>

193) 

194)     <p>If you have suggestions for improving this document, please <a

195)     href="<page about/contact>">send them to us</a>. Thanks
196)     for helping to make the Tor network grow!</p>

197)   </div>
198)   <!-- END MAINCOL -->
199)   <div id = "sidecol">
200) #include "side.wmi"
201) #include "info.wmi"
202)   </div>
203)   <!-- END SIDECOL -->
204) </div>
205) <!-- END CONTENT -->

206) #include <foot.wmi>