en/running-a-mirror.wml (27cf7da78) - 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>
 

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;
 ServerAdmin youremail@example.com
 ServerName 1.2.3.4

DocumentRoot /var/www/mirrors/torproject.org

&lt;Directory /var/www/mirrors/torproject.org/&gt;
                Options MultiViews Indexes
                DirectoryIndex index
                AllowOverride None
        &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.

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.

</div>

#include <foot.wmi>

tor-webwml.git

Add the mirror standards/requirements. Ready for push.