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 15GB of
17) disk space.  The /dist directory alone is 3.6 GB.</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 the mirrors of of high quility and up to date... Please ensure your mirror does at least the following:<br><br>

37) 

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

39) 

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

41) 

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

43) 

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

45) 

46) It is highly recommended for all mirror operators to subscribe to <A href="http://archives.seul.org/tor/mirrors/">tor-mirrors mailing list</A> where all mirror listing modification requests should go (ADD, CHANGE, DELETE, any other requests/notifications).  Also, any technical 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 -av --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) &lt;VirtualHost 1.2.3.4:80&gt;

65)         ServerAdmin youremail@example.com<br>
66)         ServerName  1.2.3.4<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.

90) </p>
91) 

92) 
93)