en/running-a-mirror.wml (cbd6ce8ad) - tor-webwml.git

running-a-mirror.wml

## translation metadata
# Revision: $Revision$
# Translation-Priority: 4-optional

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

<h2>Tor: Running a Mirror</h2>
<hr />

Thank you for wanting to be a mirror of the Tor website. All of
our mirrors are publicly listed on <a href="<page mirrors>">our mirrors
page</a>. We've included some sample commands and configuration below
to make the initial setup and ongoing maintenance a minimal effort.
The Tor website and distribution directory currently require 15GB of
disk space. The /dist directory alone is 3.6 GB.

If you would like to run a mirror (website + dist), it's as easy as this command to download
everything a mirror should share with the world:
 
<tt>
rsync -av --delete rsync://rsync.torproject.org/tor tor-mirror/
</tt>
 
If you would like to run only a dist/ mirror (distribution only), it's as easy as this command to 
download everything a dist mirror should share with the world:
 
<tt>
rsync -av --delete rsync://rsync.torproject.org/tor/dist tor-mirror-dist/
</tt>

In order to assure the mirrors of of high quility and up to date... Please ensure your mirror does at least the following:

Updates no later than every six hours, but no more frequent than every hour.

Allows "Directory Index / Indexes" (Index viewing) of the /dist directory.

Allows "Multiviews" or equivalent for language localization.

Have a valid contact email for administrative communications should your server have issues.

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.

An example cronjob to update a full mirror once every 6 hours may look like so:
<tt>
<pre>
# m h dom mon dow command
0 */6 * * * rsync -av --delete rsync://rsync.torproject.org/tor/ /var/www/mirrors/torproject.org
</pre>
</tt>

 
For mirror operators that use Apache, we have created a sample virtual host
configuration file to use:
<tt>
<pre>
&lt;VirtualHost 1.2.3.4:80&gt;
 &lt;ServerAdmin youremail@example.com&gt;
 &lt;ServerName 1.2.3.4&gt;

&lt;DocumentRoot /var/www/mirrors/torproject.org&gt;

&lt;Directory /var/www/mirrors/torproject.org/&gt;
            &lt;Options MultiViews Indexes&gt;
            &lt;DirectoryIndex index&gt;
            &lt;AllowOverride None&gt;
        &lt;/Directory&gt;

&lt;/VirtualHost&gt;
</pre>
</tt>
 
Please ensure that you keep your mirror updated (we suggest automating this
task with something like '<tt>cron</tt>'). Our website, source code and
binary releases change often. An update frequency of six hours is recommended. Tor users everywhere will thank you.

 	

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

</div>

#include <foot.wmi>

tor-webwml.git

Fix apache source appearance. Special thanks to Tas.