tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) 

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

5) 
6) <div class="main-column">
7) 
8) <h2>Tor: Running a Mirror</h2>
9) <hr />
10) 
11) <p>All of our mirrors are publicly listed on <a href="<page mirrors>">our mirrors page</a>.</p>
12) 

13) <h3>Mirroring process</h3>
14) 
15) <p>
16) The recommended method of mirroring is with rsync. There is no anonymous access to the web site files. You can set up authenticated access with the maintainer of the site you wish to mirror from, please send email to <a href="<page contact>">tor-webmaster</a>.</p>
17) <p>
18) The mirroring is a pull process, i.e. the client requests the data from the server at their own convenience. To set this up, you can use the websync script and its configuration file, which can be run from crontab, and which will do everything automatically. Follow the directions in the script to make sure everything works fine.
19) </p>
20) 
21) <h3>When to mirror</h3>
22) 
23) <p>
24) The main site gets updated frequently so we recommand to update mirror every four hours.</p>
25) <p>
26) You should calculate the mirroring time for your site according to the dates on timestamp files in /mirror/timestamps/ directory of the web site mirror. Add some time, say half an hour, to that time and mirror then.</p>
27) <p>
28) The easiest way to automatically have the mirror run every day is to use cron.
29) //ADD Command here
30)  See man crontab for details. 
31) </p>
32) 
33) <h3>Configuring the web server</h3>
34) 
35) <p>
36) This configuration is made for a standard apache server.
37) 
38) 
39) 

40) <p>
41) If you would like to run a mirror, it's as easy as this command to download
42) everything a mirror should share with the world:
43) <br /> <br />
44) <tt>

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

46) </tt>
47) <br /> <br />
48) If you would like to run a dist/ mirror, it's as easy as this command to 
49) download everything a dist mirror should share with the world:
50) <br /> <br />
51) <tt>

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

53) </tt>
54) <br/> <br/>
55) Please ensure that you keep your mirror updated (we suggest automating this
56) task with something like '<tt>cron</tt>'). Our website, source code and
57) binary releases change often. Tor users everywhere will thank you.
58) </p>
59) 
60) <p>
61) If you are running a mirror, please email

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