tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 4-optional
4) 
5) #include "head.wmi" TITLE="Tor: Running a Mirror" 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/running-a-mirror>">Running a Mirror</a>
11)   </div> 
12)   <div id="maincol"> 
13)     <h1>Tor: Running a Mirror</h1>

14)     <hr>

15)     
16)     <p>Thank you for wanting to mirror the Tor website.  All of
17)     our mirrors are publicly listed on <a href="<page getinvolved/mirrors>">our mirrors
18)     page</a>.  We've included some sample commands and configuration below
19)     to make the initial setup and ongoing maintenance a minimal effort.
20)     The Tor website and distribution directory currently require 5.0 GB of
21)     disk space.</p>
22)     
23)     <p>
24)     If you would like to run a mirror, it's as easy as this command to download
25)     everything a mirror should share with the world:

26)     <br> <br>

27)     <tt>
28)     rsync -av --delete rsync://rsync.torproject.org/tor tor-mirror/
29)     </tt>
30)     
31)     <p>
32)     In order to assure we have reliable and up to date mirrors,
33)     please ensure your mirror does at least the following:<br/><br/>
34)     
35)     Updates <b>no less</b> than every six hours, but no more frequent than every
36)     hour.<br/><br/>
37)     
38)     Allows "Directory Index / Indexes" (Index viewing) of the /dist
39)     directory.<br/><br/>
40)     
41)     Allows "Multiviews" or equivalent for language localization.<br/><br/>
42)     
43)     Have a valid contact email for administrative communications should your
44)     server have issues.<br/><br/>
45)     
46)     It is highly recommended for all mirror operators to subscribe to <A

47)     href="https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-mirrors">tor-mirrors mailing

48)     list</A> where all mirror listing modification requests should go (ADD,
49)     CHANGE, DELETE, any other requests/notifications).  Also, any technical
50)     assistance in setting up your mirror may be found here as well.<br/><br/>
51)     
52)     </p>

53)     <br><br>

54)     <p>
55)     An example cronjob to update a full mirror once every 6 hours may look like so:
56)     <tt>
57)     <pre>
58)     # m h  dom mon dow   command
59)     0 */6 * * * rsync -aq --delete rsync://rsync.torproject.org/tor/ /var/www/mirrors/torproject.org
60)     </pre>
61)     </tt>
62)     </p>
63)     <br/>
64)     For mirror operators that use Apache, we have created a sample virtual host
65)     configuration file to use:
66)     <tt>
67)     <pre>
68)     &lt;VirtualHost 0.1.2.3:80&gt;
69)             ServerAdmin youremail@example.com<br/>
70)             ServerName  0.1.2.3<br/>
71)     
72)             DocumentRoot /var/www/mirrors/torproject.org<br/>
73)     
74)             &lt;Directory /var/www/mirrors/torproject.org/&gt;<br/>
75)                 Options MultiViews Indexes<br/>
76)                 DirectoryIndex index<br/>
77)                 AllowOverride None<br/>
78)             &lt;/Directory&gt;<br/>
79)     
80)     &lt;/VirtualHost&gt;
81)     </pre>
82)     </tt>

83)     <br/>
84)     For mirror operators that use nginx, we created a sample virtual host
85)     configuration file to use:
86)     <tt>
87)     <pre>
88)     server {
89)     	listen 0.1.2.3:80;
90)   	server_name your.example.com;
91) 
92)   	root /var/www/mirrors/torproject.org;
93) 	index index.html.en;
94)     }
95)     </pre>
96)     </tt>
97)     <br/>
98)     If you use nginx, please ensure the text/html line in
99)     <tt>/etc/ngnix/mime.types</tt> matches:
100)     <tt>
101)     <pre>
102)     text/html                             en html htm shtml;
103)     </pre>
104)     </tt>
105)     <br/><br>

106)     Please ensure that you keep your mirror updated (we suggest automating this
107)     task with something like '<tt>cron</tt>'). Our website, source code and
108)     binary releases change often. An update frequency of six hours is recommended.  Tor users everywhere will thank you.
109)     </p>
110)     <br/>	
111)     <p>

112)     If you are running a mirror, please subscribe to the <A
113)     href="https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-mirrors">tor-mirrors
114)     mailing list</A>, and introduce yourself there.