tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 4-optional

4) 

5) #include "head.wmi" TITLE="Tor: Running a Mirror"

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

12) <p>Thank you for wanting to be a mirror of 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 1.6 GB of
17) disk space.  The /dist directory alone is 230 MB.</p>

18) 
19) <p>

20) If you would like to run a mirror (website + dist), 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) <br /> <br />

27) If you would like to run only a dist/ mirror (distribution only), it's as easy as this command to 

28) download everything a dist mirror should share with the world:
29) <br /> <br />
30) <tt>

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

32) </tt>

33) 
34) 
35) <p>

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

38) 

39) Updates no later than every six hours, but no more frequent than every
40) hour.<br/><br/>

41) 

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

44) 

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

46) 

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

49) 

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

55) 
56) </p>

57) <br /><br />
58) <p>

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

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

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

64) </pre>
65) </tt>
66) </p>
67) <br/>

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

69) configuration file to use:
70) <tt>
71) <pre>
72) &lt;VirtualHost 1.2.3.4:80&gt;

73)         ServerAdmin youremail@example.com<br/>
74)         ServerName  1.2.3.4<br/>

75) 

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

77) 

78)         &lt;Directory /var/www/mirrors/torproject.org/&gt;<br/>
79)             Options MultiViews Indexes<br/>
80)             DirectoryIndex index<br/>
81)             AllowOverride None<br/>
82)         &lt;/Directory&gt;<br/>

83) 

84) </VirtualHost>

85) </pre>
86) </tt>

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

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

91) </p>

92) <br/>	

93) <p>

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

98) </p>
99) 

100) 
101)