Commit 3a497092 authored by T(A)ILS developers's avatar T(A)ILS developers
Browse files

Documention++: how to setup a BitTorrent or web mirror.

parent b8ba9e9c
......@@ -7,7 +7,8 @@
<p>
There are many ways to contribute to T(A)ILS: you can write
specifications or documentation, describe your usecases, translate
this website into your native language, [[setup a mirror]]. Read on!
this website into your native language, [[setup a BitTorrent or HTTP
mirror|contribute/mirror]]. Read on!
</p>
</div> <!-- #intro-->
......
[[!meta title="Setup a Tails mirror"]]
Setting up a Tails mirror can help Tails users downloading it faster
and more reliably.
[[!toc levels=2]]
BitTorrent
==========
It's really easy to help Tails users downloading it over BitTorrent...
especially if you are already a BitTorrent user.
1. Get the latest BitTorrent files
----------------------------------
Here are the latest available BitTorrent files:
[[!map pages="torrents/files/*.torrent"]]
2. Share Tails images
---------------------
Feed your preferred BitTorrent client with the `.torrent` files
downloaded at the previous step. Make sure you open and/or forward the
needed ports in your router and/or firewall configuration so that you
are a real seed.
3. Stay tuned!
--------------
As a contributor to Tails availability over BitTorrent, it is very
important you share the very latest published version, and only this
one: users need to be able to quickly download it and upgrade when we
release security fixes, and there is no need to help propagate
outdated versions with security flaws.
[[!inline pages="stay_tuned" raw="yes"]]
HTTP
====
To efficiently help Tails users downloading it over HTTP, one needs to
have sufficiently privileged access to a web server with decent
bandwidth: a domestic DSL connection won't help, as won't a shared web
hosting setup that provides FTP access only.
This being said, if you satisfy these practical requirements, please
read on, you are most welcome aboard!
Before starting doing any real work on this topic, you should probably
get in touch (<amnesia@boum.org>) and send us your OpenPGP public key
so that any further communication between us can be properly encrypted.
1. The big picture
------------------
We have a DNS Round Robin setup for the `dl.amnesia.boum.org` host.
Every HTTP mirror makes our files available under a fixed URL
(`http://dl.amnesia.boum.org/tails/`) that contains per-version
sub-directories (such as
`http://dl.amnesia.boum.org/tails/stable/tails-i386-lenny-0.6.2/`).
2. Setup your web server
------------------------
You need to setup a VirtualHost with dl.amnesia.boum.org as the
ServerName and indexing enabled. Here is an example Apache
configuration:
<VirtualHost YOUR_WEBSERVER_IP:80>
ServerName dl.amnesia.boum.org
ServerAdmin YOUR_EMAIL
DocumentRoot /var/www/THE_PLACE_WHERE_YOU_WANT_OUR_FILES_TO_LIVE/
<Directory /var/www/THE_PLACE_WHERE_YOU_WANT_OUR_FILES_TO_LIVE/>
Options Indexes
AllowOverride None
IndexIgnore README.html
IndexOptions FancyIndexing FoldersFirst IgnoreCase NameWidth=50
IndexOrderDefault Descending Date
</Directory>
</VirtualHost>
3. Download the files
---------------------
Download a snapshot of the current Tails files:
rsync -r archive.torproject.org::amnesia-archive \
/var/www/THE_PLACE_WHERE_YOU_WANT_OUR_FILES_TO_LIVE/
4. Schedule the pulling of Tails files
--------------------------------------
Secondary mirrors (like yours) should at least sync at 01:00 UTC.
This process shall obviously be scheduled using cron or equivalent.
5. Go wild
----------
As soon as your web server is ready, please e-mail us its IP address
so that we can ask the DNS server admins to add it to the Round Robin
pool.
......@@ -6,14 +6,14 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2011-02-26 09:08-0800\n"
"PO-Revision-Date: 2011-02-26 18:12+0100\n"
"POT-Creation-Date: 2011-02-27 02:32+0100\n"
"PO-Revision-Date: 2011-02-27 02:34+0100\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: ENCODING\n"
"Language: \n"
#. type: Content of: outside any tag (error?)
msgid "[[!meta title=\"Download T(A)ILS\"]]"
......@@ -32,18 +32,16 @@ msgid ""
"it also contains a full disk image (including partition table) and can thus "
"be [[installed onto a USB stick|support/Installing onto a USB stick]]; the "
"USB stick's content is lost in the operation."
msgstr "elles contiennent aussi une image disque complète (avec table de partitions) qui peut ainsi être [[installée sur une clé USB|support/Installing onto a USB stick]] ; le contenu de la clé USB est effacé pendant cette operation."
msgstr ""
"elles contiennent aussi une image disque complète (avec table de partitions) "
"qui peut ainsi être [[installée sur une clé USB|support/Installing onto a "
"USB stick]] ; le contenu de la clé USB est effacé pendant cette operation."
#. type: Content of: <div><div><p>
msgid ""
"Any help to spread T(A)ILS is more than welcome: don't hesitate seeding our "
"Torrents. If you want to setup a web mirror, please [[drop us an email|"
"contribute]]. <strong>FIXME</strong>: link to the related documentation page."
msgstr ""
"Toute aide pour diffuser T(A)ILS est chaleureusement bienvenue :\n"
"n'hésitez pas à partager vos Torrents. Si vous voulez installer un\n"
"miroir web, [[envoyez un message|contribute]].<strong>FIXME</strong>:\n"
"lien vers la page de doc. "
"Any help to spread T(A)ILS is more than welcome, [[using BitTorrent or by "
"setting up a web mirror|contribute/mirror]]."
msgstr "Toute aide est la bienvenue pour diffuser T(A)ILS, [[via BitTorrent ou en vous occupant d'un miroir HTTP|contribute/mirror]]."
#. type: Content of: <div><div><p>
msgid ""
......@@ -201,6 +199,17 @@ msgid ""
"version [[!inline pages=\"stay_tuned\" raw=\"yes\"]]"
msgstr ""
#~ msgid ""
#~ "Any help to spread T(A)ILS is more than welcome: don't hesitate seeding "
#~ "our Torrents. If you want to setup a web mirror, please [[drop us an "
#~ "email|contribute]]. <strong>FIXME</strong>: link to the related "
#~ "documentation page."
#~ msgstr ""
#~ "Toute aide pour diffuser T(A)ILS est chaleureusement bienvenue :\n"
#~ "n'hésitez pas à partager vos Torrents. Si vous voulez installer un\n"
#~ "miroir web, [[envoyez un message|contribute]].<strong>FIXME</strong>:\n"
#~ "lien vers la page de doc. "
#~ msgid "link to the documentation"
#~ msgstr ""
#~ "Le <a href=\"https://guide.boum.org/"
......
......@@ -15,9 +15,8 @@ Every ISO image we ship is a hybrid one:
</p>
<p>
Any help to spread T(A)ILS is more than welcome: don't hesitate seeding our Torrents.
If you want to setup a web mirror, please [[drop us an
email|contribute]]. <strong>FIXME</strong>: link to the related documentation page.
Any help to spread T(A)ILS is more than welcome,
[[using BitTorrent or by setting up a web mirror|contribute/mirror]].
</p>
<p>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment