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) 
7) <div class="main-column">
8) 
9) <h2>Tor: Running a Mirror</h2>
10) <hr />
11) 

12) <p>Thank you for wanting to mirror the Tor website.  All of

13) our mirrors are publicly listed on <a href="<page mirrors>">our mirrors

14) page</a>.  We've included some sample commands and configuration below

15) to make the initial setup and ongoing maintenance a minimal effort.

16) The Tor website and distribution directory currently require 5.0 GB of

17) disk space.</p>

18) 
19) <p>

20) If you would like to run a mirror, it's as easy as this command to download

21) everything a mirror should share with the world:
22) <br /> <br />
23) <tt>

24) rsync -av --delete rsync://rsync.torproject.org/tor tor-mirror/

25) </tt>

26) 
27) <p>

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

30) 

31) Updates <b>no less</b> than every six hours, but no more frequent than every

32) hour.<br/><br/>

33) 

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

36) 

37) Allows "Multiviews" or equivalent for language localization.<br/><br/>

38) 

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

41) 

42) It is highly recommended for all mirror operators to subscribe to <A
43) href="http://archives.seul.org/tor/mirrors/">tor-mirrors mailing
44) list</A> where all mirror listing modification requests should go (ADD,
45) CHANGE, DELETE, any other requests/notifications).  Also, any technical
46) assistance in setting up your mirror may be found here as well.<br/><br/>

47) 
48) </p>

49) <br /><br />
50) <p>

51) An example cronjob to update a full mirror once every 6 hours may look like so:

52) <tt>
53) <pre>
54) # m h  dom mon dow   command

55) 0 */6 * * * rsync -aq --delete rsync://rsync.torproject.org/tor/ /var/www/mirrors/torproject.org

56) </pre>
57) </tt>
58) </p>
59) <br/>

60) For mirror operators that use Apache, we have created a sample virtual host

61) configuration file to use:
62) <tt>
63) <pre>

64) <VirtualHost 0.1.2.3:80>

65)         ServerAdmin youremail@example.com<br/>

66)         ServerName  0.1.2.3<br/>

67) 

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

69) 

70)         &lt;Directory /var/www/mirrors/torproject.org/&gt;<br/>
71)             Options MultiViews Indexes<br/>
72)             DirectoryIndex index<br/>
73)             AllowOverride None<br/>
74)         &lt;/Directory&gt;<br/>

75) 

76) </VirtualHost>

77) </pre>
78) </tt>

79) <br/> <br/>
80) Please ensure that you keep your mirror updated (we suggest automating this
81) task with something like '<tt>cron</tt>'). Our website, source code and

82) binary releases change often. An update frequency of six hours is recommended.  Tor users everywhere will thank you.

83) </p>

84) <br/>	

85) <p>

86) If you are running a mirror, please subscribe to the
87) <A href="http://archives.seul.org/tor/mirrors/">tor-mirrors mailing list</A>, and introduce yourself there.
88) We will add you to the mirror list.  
89) Help for mirror support and configuration issues may also be found on the list.