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, 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, 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 a day may look like so:
36) <tt>
37) <pre>
38) # m h  dom mon dow   command
39) 1 4 * * * 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've 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
56)                 DirectoryIndex index
57)                 AllowOverride None
58)         &lt;/Directory&gt;
59) 
60) &lt;VirtualHost&gt;
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. Tor users everywhere will thank you.
67) </p>

68) <br/>

69) <p>
70) If you are running a mirror, please email

71) <a href="<page contact>">tor-webmaster</a> and we'll add it to the list.