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) <br /><br />
34) <p>

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

36) <tt>
37) <pre>
38) # m h  dom mon dow   command

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

40) </pre>
41) </tt>
42) </p>
43) <br/>

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

45) configuration file to use:
46) <tt>
47) <pre>
48) &lt;VirtualHost 1.2.3.4:80&gt;
49)         ServerAdmin youremail@example.com
50)         ServerName  1.2.3.4
51) 
52)         DocumentRoot /var/www/mirrors/torproject.org
53) 
54)         &lt;Directory /var/www/mirrors/torproject.org/&gt;

55)                 Options MultiViews Indexes

56)                 DirectoryIndex index
57)                 AllowOverride None
58)         </Directory>
59) 

60) </VirtualHost>

61) </pre>
62) </tt>

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

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

67) </p>

68) <br/>

69) <p>

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

74) </p>
75) 

76) <p>
77) In order to assure the mirrors of of high quility and up to date... Please ensure your mirror does at least the following:
78) 
79) Updates no later than every six hours, but no more frequent than every hour.
80) 
81) Allows "Directory Index / Indexes" (Index viewing) of the /dist directory.
82) 
83) Allows "Multiviews" or equivalent for language localization.
84) 
85) Have a valid contact email for administrative communications should your server have issues.
86) 
87) 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.
88) 
89) </p>
90) 
91)