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 roughly
21)     24GB of disk space, but this number can fluctuate. Expect space
22)     requirements of up to 30 GB.
23)     </p>

24)     <h2><a class="anchor" href="#sysconfig">Configuring your System</a></h2>

25)     <p>

26)     If you would like to run a mirror, it's as easy as these commands to download

27)     everything a mirror should share with the world:

28)     </p>

29)     <tt>

30) <pre>

31) rsync -aq --exclude dist --delete rsync://rsync.torproject.org/website-mirror/ /var/www/mirrors/torproject.org
32) rsync -aq --delete rsync://rsync.torproject.org/dist-mirror/ /var/www/mirrors/torproject.org/dist

33) </pre>

34)     </tt>

35) 

36)     <p>
37)     In order to assure we have reliable and up to date mirrors,
38)     please ensure your mirror does at least the following:<br/><br/>

39) 

40)     Updates <b>no less</b> than every six hours, but no more frequent than every
41)     hour.<br/><br/>

42) 

43)     Allows "Directory Index / Indexes" (Index viewing) of the /dist
44)     directory.<br/><br/>

45) 

46)     Have a valid contact email for administrative communications should your
47)     server have issues.<br/><br/>

48) 

49)     It is highly recommended for all mirror operators to subscribe to <A

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

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

54) 

55)     </p>

56)     <br><br>

57)     <p>
58)     An example cronjob to update a full mirror once every 6 hours may look like so:

59)     </p>

60)     <tt>

61) <pre>
62) # m h  dom mon dow   command

63) 0 */6 * * * rsync -aq --exclude dist --delete rsync://rsync.torproject.org/website-mirror/ /var/www/mirrors/torproject.org

64) 5 */6 * * * rsync -aq --delete rsync://rsync.torproject.org/dist-mirror/ /var/www/mirrors/torproject.org/dist
65) </pre>

66)     </tt>

67)     <p>

68)     For mirror operators that use Apache, we have created a sample virtual host
69)     configuration file to use:

70)     </p>

71)     <tt>

72) <pre>
73) &lt;VirtualHost 10.10.10.10:80&gt;

74)     ServerAdmin youremail@example.com<br/>
75)     ServerName  ServerNameHere<br/>

76) 

77)     DocumentRoot /var/www/mirrors/torproject.org<br/>

78) 

79)     &lt;Directory /var/www/mirrors/torproject.org/&gt;<br/>

80)         # Be sure to enable the autoindex and negotiation modules<br/>
81)         Options MultiViews Indexes<br/>

82)         DirectoryIndex index<br/>
83)         AllowOverride None<br/>
84)     &lt;/Directory&gt;<br/>

85) 

86) </VirtualHost>
87) </pre>

88)     </tt>

89)     <p>

90)     For mirror operators that use nginx, we created a sample virtual host
91)     configuration file to use:

92)     </p>

93)     <tt>

94) <pre>
95) server {
96)     listen 10.10.10.10:80;
97)     server_name your.example.com;

98) 

99)     root /var/www/mirrors/torproject.org;
100)     index index.html.en;

101) 

102)     location  / {
103)         autoindex on;

104)     }

105) }
106) </pre>

107)     </tt>

108)     <p>

109)     If you use nginx, please ensure the text/html line in

110)     <tt>/etc/nginx/mime.types</tt> matches:

111)     </p>

112)     <tt>

113) <pre>
114) text/html                             en html htm shtml;
115) </pre>

116)     </tt>
117)     <br/><br>

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

122)     <br/>

123)     <h2><a class="anchor" href="#mirrorops">Joining the mirror community</a></h2>

124)     <p>

125)     If you are running a mirror, please subscribe to the <A
126)     href="https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-mirrors">tor-mirrors

127)     mailing list</A>, and introduce yourself there. Help for mirror
128)     support and configuration issues may also be found on the list.
129)     </p>

130) 

131)     <p>
132)     In order to add your mirror, please send a
133)     single, comma delimited line of text based on <a
134)     href="https://svn.torproject.org/svn/website/trunk/include/tor-mirrors.csv">this
135)     file</a> to the mirrors list. Your mirror will then be added manually
136)     if it passes availability testing and your provided information is

137)     confirmed. Some general pointers on mirrors are:

138)     <ol><li> Try not to run your mirror behind a content delivery network
139)     (such as Akamai, Cloudflare, Fastly, etc) as most of them block

140)     access from countries where the mirror is needed the most.</li>
141)     <li> Try not to redirect http to https. Many places in the world

142)     cannot use https due to local or national firewalls.</li>

143)     </ol>

144)     </p>
145)   </div>
146)   <!-- END MAINCOL -->
147)   <div id = "sidecol">
148) #include "side.wmi"
149) #include "info.wmi"
150)   </div>
151)   <!-- END SIDECOL -->
152) </div>
153) <!-- END CONTENT -->